Method Name
private/poll_quotes
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[].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}