Skip to main content
POST
/
v1
/
maker
/
quotes
Submit a quote
curl --request POST \
  --url https://combos-rfq-api.polymarket.sh/v1/maker/quotes \
  --header 'Content-Type: application/json' \
  --header 'POLY_ADDRESS: <api-key>' \
  --header 'POLY_API_KEY: <api-key>' \
  --header 'POLY_PASSPHRASE: <api-key>' \
  --header 'POLY_SIGNATURE: <api-key>' \
  --header 'POLY_TIMESTAMP: <api-key>' \
  --data '
{
  "quote_id": "quote_<id>",
  "rfq_id": "rfq_<id>",
  "signer_address": "0xYourSigner",
  "maker_address": "0xYourQuoterWallet",
  "signature_type": 0,
  "price_e6": "450000",
  "size_e6": "1000000",
  "signed_order": {
    "salt": "<order_salt>",
    "maker": "0xYourQuoterWallet",
    "signer": "0xYourSigner",
    "tokenId": "<yes_or_no_position_id>",
    "makerAmount": "<amount_to_pay>",
    "takerAmount": "<taker_amount>",
    "side": 0,
    "signatureType": 0,
    "timestamp": "<unix_seconds>",
    "metadata": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "builder": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "signature": "0x..."
  }
}
'
{
  "request": {
    "rfq_id": "<string>",
    "leg_position_ids": [
      "<string>"
    ],
    "auth_address": "<string>",
    "signer_address": "<string>",
    "maker_address": "<string>",
    "signature_type": 0,
    "requestor_public_id": "<string>",
    "condition_id": "<string>",
    "yes_position_id": "<string>",
    "no_position_id": "<string>",
    "requested_size": {
      "value_e6": "1000000"
    },
    "created_at": 123
  },
  "competition_started_at": 123,
  "competition_ends_at": 123,
  "confirmation_started_at": 123,
  "confirmation_ends_at": 123,
  "quote_id": "<string>",
  "bundle": {
    "requested_shares_e6": "<string>",
    "blended_price_e6": "<string>",
    "allocations": [
      {
        "maker_quote_id": "<string>",
        "signer_address": "<string>",
        "maker_address": "<string>",
        "size_e6": "<string>",
        "price_e6": "<string>",
        "received_at": 123
      }
    ],
    "requested_notional_e6": "<string>"
  },
  "maker_confirmations": [
    {
      "quote_id": "<string>",
      "signer_address": "<string>",
      "maker_address": "<string>",
      "reason": "<string>",
      "responded_at": 123
    }
  ]
}

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[]