Skip to main content
POST
/
v1
/
trades
cURL
curl --request POST \
  --url https://api.sandbox.forte.cc/v1/trades \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instrument": "AUDF/USDT",
  "side": "buy",
  "price": "0.63",
  "amount": "10",
  "currency": "AUDF",
  "externalId": "client-trade-000123"
}
'
{
  "id": "5f63179b-61cb-4b72-9d3d-b02fea7c5611",
  "instrument": "AUDF/USDT",
  "side": "buy",
  "price": "0.6295",
  "amount": "10",
  "currency": "AUDF",
  "buyAmount": "10",
  "buyCurrency": "AUDF",
  "sellAmount": "6.295",
  "sellCurrency": "USDT",
  "createdAt": "2024-06-27T00:45:10.040Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Trade request.

​
instrument
string
required

Instrument to trade (BASE/QUOTE).

Example:

"AUDF/USDT"

​
side
enum<string>
required

Specifies the trade direction relative to the base currency of instrument.

Available options:
buy,
sell
Example:

"buy"

​
price
string
required

Limit price for trade execution. Matched price will be the prevailing price and may be better than the limit price.

Example:

"0.63"

​
amount
string
required

Amount to buy or sell (in currency if provided, otherwise in base currency).

Example:

"10"

​
currency
string

Optional currency for amount. If omitted, defaults to the base currency of the instrument (the first currency).

Example:

"AUDF"

​
externalId
string

Optional external identifier provided by the client.

Example:

"client-trade-000123"

Response

200 - application/json

Executed trade

​
id
string<uuid>

Trade identifier.

Example:

"5f63179b-61cb-4b72-9d3d-b02fea7c5611"

​
instrument
string

Instrument traded (BASE/QUOTE).

Example:

"AUDF/USDT"

​
side
enum<string>

Specifies the trade direction relative to the base currency of instrument.

Available options:
buy,
sell
Example:

"buy"

​
price
string

Executed price.

Example:

"0.6295"

​
amount
string

Requested amount (in currency).

Example:

"10"

​
currency
string

Currency of amount.

Example:

"AUDF"

​
buyAmount
string

Amount purchased (in buyCurrency).

Example:

"10"

​
buyCurrency
string

Currency of buyAmount.

Example:

"AUDF"

​
sellAmount
string

Amount sold (in sellCurrency).

Example:

"6.295"

​
sellCurrency
string

Currency of sellAmount.

Example:

"USDT"

​
createdAt
string<date-time>

Creation timestamp (ISO 8601).

Example:

"2024-06-27T00:45:10.040Z"