Trading API Reference

Trade Orders

Submit a quote for execution and receive a deposit address.

POST/api/v1/trade-order/
Create a trade order from a still-valid quote.

Submits a quote for execution. The response includes the deposit address you must fund (for BUY) or that Bitrus will deliver to (for SELL), and an initial RECEIVED status. Subsequent transitions (WAITING_DEPOSIT, DEPOSIT_RECEIVED, ASSET_SENT, COMPLETE) are asynchronous. The quote must be unexpired.

JWT requiredClient Agent

Request body

PropType

Example request

cURL

curl -X POST https://api.bitrus.com/api/v1/trade-order/ \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"quote_id":"ad5f2fa3-7f1b-4d0c-9d81-1f2c3cba9c01","network":"POLYGON"}'

Request body

2 keys
"body": {
"quote_id": "ad5f2fa3-7f1b-4d0c-9d81-1f2c3cba9c01",
"network": "POLYGON"
}

Responses

201Order created and queued for processing.TradeOrderResponse

Response fields

PropType

Example response

4 keys
"response": {
"id": "8b6d2b71-9e0e-4af2-a4f5-cd24e7c1a8a3",
"status": "RECEIVED",
"deposit_address": {
"network": "POLYGON",
"address": "0xe890c5e40375f4787a49cba184e7ee1553f77e6b"
},
"created_at": "2026-04-27T15:42:30.000000Z"
}

Errors

StatusCodeWhen
  • 422InvalidQuoteQuote not found, expired, or no deposit/withdraw address registered for the requested network.
  • 403ForbiddenQuoteQuote belongs to a different customer.
  • 409OrderWithDuplicatedQuoteErrorThe quote has already been used.

All responses include X-Transaction-Id andX-Process-Time headers.