Skip to main content
POST
Submit a quote

Authorizations

POLY_API_KEY
string
header
required

CLOB API key

POLY_ADDRESS
string
header
required

Wallet address associated with the API key

POLY_SIGNATURE
string
header
required

HMAC-SHA256 signature of the request

POLY_PASSPHRASE
string
header
required

CLOB API key passphrase

POLY_TIMESTAMP
string
header
required

Unix timestamp of the request

Body

application/json

A signed maker quote.

quote_id
string
required

Maker-generated quote ID (required for REST submissions).

Example:

"quote_<id>"

rfq_id
string
required

RFQ ID from the RFQ_REQUEST.

Example:

"rfq_<id>"

signer_address
string
required
Example:

"0xYourSigner"

maker_address
string
required
Example:

"0xYourQuoterWallet"

signature_type
enum<integer>
required

CLOB signature type:

  • 0 EOA
  • 1 POLY_PROXY
  • 2 GNOSIS_SAFE
  • 3 POLY_1271
Available options:
0,
1,
2,
3
Example:

0

price_e6
string
required

Quote price in six-decimal fixed-point units (must be positive).

Example:

"450000"

size_e6
string
required

Fillable share count in six-decimal fixed-point units (must be positive). Note this differs from the request's size field, which may be notional or shares.

Example:

"1000000"

signed_order
object
required

Signed Exchange v3 order. Combinatorial RFQ trades settle through Exchange v3.

valid_until
integer<int64>

Optional quote expiry in Unix milliseconds.

Response

Current RFQ snapshot after the quote was accepted

Point-in-time view of an RFQ and its competition/confirmation windows.

request
object
required

The RFQ request as stored by the engine.

status
enum<string>
required

Lifecycle status of the RFQ

Available options:
CREATED,
COLLECTING_QUOTES,
AWAITING_REQUESTER_ACCEPTANCE,
AWAITING_MAKER_CONFIRMATION,
EXECUTING,
FILLED,
FAILED,
EXPIRED,
CANCELED,
REJECTED
competition_started_at
integer<int64>

Unix milliseconds.

competition_ends_at
integer<int64>

Unix milliseconds.

confirmation_started_at
integer<int64>

Unix milliseconds.

confirmation_ends_at
integer<int64>

Unix milliseconds.

quote_id
string
bundle
object

The selected executable bundle of maker allocations.

maker_confirmations
object[]