POST /exchange/rates

​
Request

  • Headers: Content-Type: application/json

  • Body (required):

{
  "buy": 100,
  "pair": "USD-NGN",
  "sell": 75000,
  "ttl": 60
}

  • buy (integer): Buy amount in base currency.

  • pair (string): Currency pair (e.g., “USD-NGN”).

  • sell (integer): Sell amount in quote currency.

  • ttl (integer): Time-to-live for the rate, in seconds.

​
Sample Response

  1. 201 Created

    • Media Type: application/json
{
  "data": {
    "accepted_at": "2023-12-23T17:55:42.919523",
    "correlation_id": "7da742ea-a1bc-11ee-b907-560f156a658b",
    "created_at": "2023-12-23T17:55:42.911",
    "entity": {
      "id": "6ebe0a0f-bb8f-49be-80ea-c6b72c348fea",
      "type": "business"
    },
    "expires_at": null,
    "id": "7da75a46-a1bc-11ee-9a32-560f156a658b",
    "min_qty": null,
    "min_quote_qty": null,
    "percent_filled": 10000,
    "price": 80000,
    "price_type": "market",
    "qty": 1,
    "quote_qty": null,
    "status": "filled",
    "symbol": "USD-NGN",
    "time_in_force": "gtc",
    "trades": [
      {
        "buy_order_id": "7da75a46-a1bc-11ee-9a32-560f156a658b",
        "commission": 0,
        "correlation_id": "7da742ea-a1bc-11ee-b907-560f156a658b",
        "created_at": "2023-12-23T17:55:42.921",
        "id": "7da8e726-a1bc-11ee-80cf-560f156a658b",
        "price": 80000,
        "sell_order_id": "7d97c0b8-a1bc-11ee-b240-560f156a658b",
        "size": 1,
        "symbol": "USD-NGN"
      }
    ],
    "type": "buy",
    "updated_at": "2023-12-23T17:55:42.911"
  }
}
  1. 422 Unprocessable Entity

  • Media Type: application/json

  • Indicates validation errors or invalid request parameters.

ConvertDelete Rates