Skip to main content
GET /exchange/quote/{id}}
Parameters:
  • source_currency (string, required): Source currency (e.g., USD).
  • target_currency (string, required): Target currency (e.g., NGN).
Sample Request 
curl --location 'https://api.spendjuice.com/exchange/quote?source_currency=NGN&target_currency=USD' \
--header 'Authorization: <API-KEY>'
Sample Response 
{
  "data": {
    "id": "2f939fe5-fb7b-4234-8b73-761a848d13af",
    "locked": true,
    "rate": 1500,
    "symbol": "USD-NGN",
    "time_to_convert": 10,
    "time_to_lock": 30,
    "type": "buy"
  }
}
Path Parameter:
  • id (string, required): The unique identifier of the rate to retrieve. Example: 3f27a046-314d-457f-b39b-1ec30561353d
  • .time_to_convert
    • Description: The Time-To-Live (TTL) of the rate in seconds.
  • time_to_lock
    • Description: The duration (in seconds) before the rate becomes available for locking while it is being unlocked.
  • locked
    • Description:
      • A locked quote is available for use in a swap within the time_to_convert interval.
      • An unlocked rate will become unavailable after the time_to_lock interval.
      • By default, the quote is locked for authenticated requests.
      • To prevent locking, add lock=false to the quote endpoint parameters.
  • type
    • Description: Specifies the conversion side from the provider’s perspective. Possible values are buy or sell.

​
Locking a Rate

Once you have fetched a quote, you can use the request below to lock it in. 
curl --location --request POST 'https://api.spendjuice.com/exchange/quote/<quote_id>/lock' \
--header 'Authorization: <API-KEY>'