API Reference

Fetch exchange rate

posthttps://api-sandbox.circle.com/v1/exchange/quotes

  • Reference
  • Playground

Fetches an indicative exchange rate between two currencies. Either the from currency or to currency must be USD.

Note: The current market exchange rate will be applied when Circle receives the deposit.

Body parameters
to
object
Required
amount
string

Magnitude of the amount, in units of the currency, with a ..

currency
string
Required

Currency code.

Allowed valuesUSDEURMXNSGDBRL
from
object
Required
amount
string

Magnitude of the amount, in units of the currency, with a ..

currency
string
Required

Currency code.

Allowed valuesUSDEURMXNSGDBRL
type
string
Required

The type of exchange.

Allowed valuesreferencetradable
idempotencyKey
string
Required

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests.

Response
RequestChoose a language
ResponseChoose an example
1{
2  "data": {
3    "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
4    "rate": 0.1974,
5    "from": {
6      "amount": "3.14",
7      "currency": "USD"
8    },
9    "to": {
10      "amount": "3.14",
11      "currency": "USD"
12    },
13    "expiry": "2020-04-10T02:13:30.000Z",
14    "type": "reference"
15  }
16}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.