Poll Quotes

Method Name

`private/poll_quotes`

Retrieves a list of quotes matching filter criteria.
Takers can use this to poll open quotes that they can fill against their open RFQs.
Required minimum session key permission level is read_only

Parameters


subaccount_id integer required Subaccount ID for auth purposes, returned data will be scoped to this subaccount.
from_timestamp integer Earliest timestamp to filter by (in ms since Unix epoch). If not provied, defaults to 0.
page integer Page number of results to return (default 1, returns last if above `num_pages`)
page_size integer Number of results per page (default 100, max 1000)
quote_id string Quote ID filter, if applicable
rfq_id string RFQ ID filter, if applicable
status string Quote status filter, if applicable enum `open` `filled` `cancelled` `expired`
to_timestamp integer Latest timestamp to filter by (in ms since Unix epoch). If not provied, defaults to returning all data up to current time.

Response


id string or integer required
result object required
result. pagination object required Pagination info
result.pagination. count integer required Total number of items, across all pages
result.pagination. num_pages integer required Number of pages

result. quotes array of objects required Quotes matching filter criteria
result.quotes[]. cancel_reason string required Cancel reason, if any enum `user_request` `insufficient_margin` `signed_max_fee_too_low` `mmp_trigger` `cancel_on_disconnect` `session_key_deregistered` `subaccount_withdrawn` `rfq_no_longer_open` `compliance`
result.quotes[]. creation_timestamp integer required Creation timestamp in ms since Unix epoch
result.quotes[]. direction string required Quote direction enum `buy` `sell`
result.quotes[]. fill_pct string required Percentage of the RFQ that this quote would fill, from 0 to 1.
result.quotes[]. last_update_timestamp integer required Last update timestamp in ms since Unix epoch
result.quotes[]. legs_hash string required Hash of the legs of the best quote to be signed by the taker.
result.quotes[]. liquidity_role string required Liquidity role enum `maker` `taker`
result.quotes[]. quote_id string required Quote ID
result.quotes[]. rfq_id string required RFQ ID
result.quotes[]. status string required Status enum `open` `filled` `cancelled` `expired`
result.quotes[]. subaccount_id integer required Subaccount ID
result.quotes[]. tx_hash string or null required Blockchain transaction hash (only for executed quotes)
result.quotes[]. tx_status string or null required Blockchain transaction status (only for executed quotes) enum `requested` `pending` `settled` `reverted` `ignored` `timed_out`
result.quotes[]. wallet string required Wallet address of the quote sender
result.quotes[]. legs array of objects required Quote legs
result.quotes[].legs[]. amount string required Amount in units of the base
result.quotes[].legs[]. direction string required Leg direction enum `buy` `sell`
result.quotes[].legs[]. instrument_name string required Instrument name
result.quotes[].legs[]. price string required Leg price

Example

{request_example_shell}

{request_example_javascript}

{request_example_python}

The above command returns JSON structured like this:

{response_example_json}