Trading

Place easy buy/sell order

Executes an easy buy or sell against the live orderbook.

Requires the trade permission on the API key.

Buy - set side to buy and provide amount as the quote currency to spend (e.g. ZAR or USDT). The coin quantity is derived automatically.

Sell - set side to sell and provide amount as the coin quantity to sell. The quote proceeds are calculated automatically.

client_order_id acts as an idempotency key: submitting the same value twice returns the original result without placing a second order.

post/easybuy

Request body

side'buy' | 'sell' required

tickerstring required

Coin symbol.

amountstring required

For buy orders: the quote currency amount to spend. For sell orders: the coin quantity to sell.

client_order_idstring

Optional idempotency key.

Example request

{
  "side": "buy",
  "ticker": "BTC",
  "amount": "1000.00",
  "client_order_id": "optional-uuid"
}

Response

Easy buy/sell order filled successfully.

okboolean required

Example response

{
  "ok": true,
  "result": {
    "status": "FILLED",
    "filled_qty": "0.00123456",
    "filled_quote_qty": "1000.00",
    "avg_price": "810000.00",
    "fee_pct": "0.001",
    "fee_amount": "1.00",
    "net_amount": "999.00"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.