Skip to main content
POST
Generate a reverse quote

Authorizations

Authorization
string
header
required

ES256-signed JWT bearer token, single-use, 60-second TTL. See Authentication for how to mint one.

X-Request-Signature
string
header
required

ES256 signature over the request, bound to the bearer JWT. Required on every v3 request. See Authentication → Request signing.

Headers

Idempotency-Key
string
required

Client-generated unique key to make a write operation safely retryable. UUID v4 recommended. See Idempotency.

Required string length: 1 - 255
Pattern: ^[a-zA-Z0-9_-]{1,255}$
Example:

"550e8400-e29b-41d4-a716-446655440000"

X-Request-Id
string

Optional, client-supplied correlation ID for this request. Echoed verbatim on the response when supplied; the response omits it when the request did not supply one. Distinct from X-Trace-Id (server-generated, always present). See Metadata & tracing.

Example:

"my-req-abc-123"

Path Parameters

id
string
required

Unique identifier of the trade to reverse. Accepts either the current readable, typed-prefix ID (see ResourceId) or a legacy bare UUID v4, for backward compatibility with IDs persisted before v3 introduced readable IDs. Both forms resolve to the same underlying record. Responses always return the readable form — see Resource IDs.

Pattern: ^([a-z]{3,5}_[1-9A-HJ-NP-Za-km-z]{1,22}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$
Example:

"tde_5W7guYdHT24JFnRQrZN9y8"

Body

application/json

Requests a reverse quote for the trade in the path.

quoteForSeconds
enum<number>
default:3

Requested reverse-quote validity in seconds.

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

30

Response

Generate a reverse quote.

data
object
required

A time-limited preview of the amounts and differential for reversing a specific trade. Execute the reversal with POST /v3/fx/trades/{id}/reverse before expiresAt.