Skip to main content
POST
Generate a reverse quote
Generates a time-limited quote that previews the amounts and differential for reversing an existing trade. Pass the returned quote’s id to Reverse a trade. Use this endpoint to:
  • Preview the reversal amount and differential before committing
  • Get a guaranteed rate for the reversal
  • Decide whether a reversal is worth executing
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

V2 only. Unique key for an idempotent reverse quote request. Valid for 30 minutes.

Example:

"323e4567-e89b-42d3-a456-426614174000"

Path Parameters

orgId
string
required

Body

application/json
tradeId
string<uuid>
required

Unique identifier of the trade to reverse

Example:

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

quoteForSeconds
enum<number>
default:3

Requested reverse quote expiry validity in seconds.

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

30

Response

Reverse quote generated successfully

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

"success"

message
string
Example:

"Data fetched successfully"