Skip to main content
PUT
Quote an RFQ

Authorizations

X-Monaco-Signature
string
header
required

Ed25519 session-key request signing. Every authenticated request carries three headers: X-Monaco-PublicKey (64-char lowercase-hex session public key), X-Monaco-Timestamp (Unix milliseconds, within 30s of server time), and X-Monaco-Signature (hex ed25519 signature). The signature is over METHOD\npath?query\ntimestamp_ms\nSHA256_hex(body), where the body hash is the SHA-256 of the empty byte string when there is no body. Obtain the session keypair from POST /api/v1/auth/challenge followed by POST /api/v1/auth/verify.

Path Parameters

rfqId
string
required

Body

application/json
idempotencyKey
string
required
expectedVersion
integer<int64>
required

The caller's current version for this RFQ; 0 for its first quote

marginMode
string | null

Perpetuals: ISOLATED (the default) or CROSS, as on an order

bid
object

A quote's price and capacity.

ask
object

A quote's price and capacity.

validityMs
integer<int64> | null

15000 to 60000; absent means 60000. Capped at the request deadline

leverage
string | null

Perpetuals: the leverage each side's order reserves with, as on an order (required there, refused on spot). Fixed while a side rests: a new version with another leverage or margin mode is refused; withdraw and quote again

Example:

"5"

Response

OK

A quote version as its maker sees it.

rfqId
string<uuid> | null
quoteId
string<uuid> | null
version
integer<int64> | null

This version; name it to replace or withdraw

bid
object

A quote's price and capacity.

ask
object

A quote's price and capacity.

issuedAtMs
integer<int64> | null
validUntilMs
integer<int64> | null
leverage
string | null

Perpetuals: the leverage the quote's orders reserve with

marginMode
string | null

Perpetuals: ISOLATED or CROSS

refusedSides
object[] | null

Quoted sides the venue refused. A quote reserves funds as a resting limit order does, each side on its own: the version holds only the funded sides, and a refused side on a replacement is withdrawn. When no side is funded the quote is refused instead