Skip to main content
POST
Generate quote
Creates a new quote for a specific currency pair and amount, returning a quote ID and guaranteed rate valid for 3 seconds by default. Set quoteForSeconds to extend validity up to 60 seconds. Use this endpoint to:
  • Get real-time exchange rates
  • Lock in rates for trading
  • Calculate exchange amounts
  • Review applicable fees and margins
Idempotency required. This POST requires an Idempotency-Key header. Keys are cached for 30 minutes. Reusing the same key with the same body returns the cached response; reusing it with different parameters returns a 422 error.

Errors

See the full v2 error reference for retry semantics and idempotency-specific codes.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string<uuid>
required

Unique key to ensure idempotent requests. UUID v4 recommended. Valid for 30 minutes.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Path Parameters

orgId
string
required

Body

application/json
amount
number
required
Example:

1000

buy
string
required
Example:

"USDC"

sell
string
required
Example:

"USD"

referencedUnit
string
required
Example:

"USDC"

quoteForSeconds
enum<number>
default:3

Requested quote expiry validity in seconds.

Available options:
3,
15,
30,
45,
60
Example:

3

Response

success

status
enum<string>
Available options:
success,
error
Example:

"success"

data
object
message
string
Example:

"Data fetched successfully"