PATCH /exchange/rates/{id}

​
Request

  • Headers: Authorization: Bearer <token>

  • Path Parameter:

    • id (string, required): The unique identifier of the rate to update. Example: 3f27a046-314d-457f-b39b-1ec30561353d

  • Body (required):

    • Media Type: application/json
{
  "buy": 100,
  "sell": 75000,
  "ttl": 60
}

Fields:

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

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

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

​
Responses

  1. 201 Created

    • Media Type: application/json

    • Sample Response:

{
  "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. 404 Not Found

  • Media Type: application/json

  • Returned if the specified id does not exist.

  1. 422 Unprocessable Entity

  • Media Type: application/json

  • Returned if the request body contains invalid or missing parameters.

Supported Rates.List Swaps