Quickstart

This guide takes you from login to your first trade in five steps.

Prerequisites

An Amana account with API access. See Getting started.
For business access, your server IP addresses must be whitelisted.
The base URL for your environment ‹confirm with Amana›.

Orders placed in production use real money. Run this guide in the sandbox ‹sandbox URL› first.

Set your base URL once so you can copy the examples:

export BASE_URL="‹base URL›"

Send your email and password to get an access token.

curl -X POST "$BASE_URL/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'

{
  "access_token": "eyJhbGciOi...",
  "refresh_token": "eyJhbGciOi...",
  "passkey": false
}

Save the access_token and send it as a Bearer token in every following request.

export TOKEN="eyJhbGciOi..."

Check your balance

Get your trading account, including the balance and account currency.

curl "$BASE_URL/trading/me" \
  -H "Authorization: Bearer $TOKEN"

The user.balance field shows your balance and user.currency shows the account currency.

Find an instrument

Search for the instrument you want to trade.

curl "$BASE_URL/trading/symbols/search?query=AAPL" \
  -H "Authorization: Bearer $TOKEN"

Use the symbol value from the results when you place the order.

Place a market order

Buy $100 of the instrument. Set the size in USD with amount. The sl (stop loss) and tp (take profit) prices are optional.

curl -X POST "$BASE_URL/trading/positions/market" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL", "side": "buy", "amount": 100, "sl": 180, "tp": 220}'

{
  "success": true,
  "orderId": "123456"
}

View and close the position

List your open positions and note the id of the one you opened.

curl "$BASE_URL/trading/positions" \
  -H "Authorization: Bearer $TOKEN"

Close the position at the current market price.

curl -X DELETE "$BASE_URL/trading/positions/{id}" \
  -H "Authorization: Bearer $TOKEN"

Next steps

Browse every endpoint in the API reference.
Learn how to handle failures in Error codes.

Get started

API essentials

Prerequisites

Next steps

​Prerequisites

​Next steps

Prerequisites

Next steps