Method Name
private/poll_rfqs
private/poll_rfqsRetrieves a list of RFQs matching filter criteria. Market makers can use this to poll RFQs directed to them.
Required minimum session key permission level is read_only
Parameters
| subaccount_idintegerrequired Subaccount ID for auth purposes, returned data will be scoped to this subaccount. |
| from_timestampinteger Earliest last_update_timestamp to filter by (in ms since Unix epoch). If not provied, defaults to 0. |
| pageinteger Page number of results to return (default 1, returns last if above num_pages) |
| page_sizeinteger Number of results per page (default 100, max 1000) |
| rfq_idstring RFQ ID filter, if applicable |
| rfq_subaccount_idinteger Filter returned RFQs by rfq requestor subaccount |
| statusstring RFQ status filter, if applicable enum openfilledcancelledexpired |
| to_timestampinteger Latest last_update_timestamp to filter by (in ms since Unix epoch). If not provied, defaults to returning all data up to current time. |
Response
| idstring or integerrequired |
| resultobjectrequired |
| result.paginationobjectrequired Pagination info |
| result.pagination.countintegerrequired Total number of items, across all pages |
| result.pagination.num_pagesintegerrequired Number of pages |
| result.rfqsarray of objectsrequired RFQs matching filter criteria |
| result.rfqs[].cancel_reasonstringrequired Cancel reason, if any enum user_requestinsufficient_marginsigned_max_fee_too_lowmmp_triggercancel_on_disconnectsession_key_deregisteredsubaccount_withdrawnrfq_no_longer_opencompliance |
| result.rfqs[].creation_timestampintegerrequired Creation timestamp in ms since Unix epoch |
| result.rfqs[].fill_ratestring or nullrequired Average taker fill rate, from 0 to 1. Returns null for users with insufficient RFQ history. |
| result.rfqs[].filled_directionstring or nullrequired Direction at which the RFQ was filled (only if filled) enum buysell |
| result.rfqs[].filled_pctstringrequired Percentage of the RFQ that has been filled, from 0 to 1. |
| result.rfqs[].last_update_timestampintegerrequired Last update timestamp in ms since Unix epoch |
| result.rfqs[].partial_fill_stepstringrequired Step size for partial fills (default: 1) |
| result.rfqs[].preferred_directionstring or nullrequired If disclosed, the direction the user is aiming to execute as. enum buysell |
| result.rfqs[].recent_fill_ratestring or nullrequired Taker fill rate, weighted towards the recent several days of activity, from 0 to 1. Returns null for users with insufficient recent RFQ history. |
| result.rfqs[].reducing_directionstring or nullrequired If applicable, the direction from user's perspective that would reduce their position in each leg. enum buysell |
| result.rfqs[].rfq_idstringrequired RFQ ID |
| result.rfqs[].statusstringrequired Status enum openfilledcancelledexpired |
| result.rfqs[].subaccount_idintegerrequired Subaccount ID |
| result.rfqs[].total_coststring or nullrequired Total cost for the RFQ (only if filled) |
| result.rfqs[].valid_untilintegerrequired RFQ expiry timestamp in ms since Unix epoch |
| result.rfqs[].walletstringrequired Wallet address of the RFQ sender |
| result.rfqs[].legsarray of objectsrequired RFQ legs |
| result.rfqs[].legs[].amountstringrequired Amount in units of the base |
| result.rfqs[].legs[].directionstringrequired Leg direction enum buysell |
| result.rfqs[].legs[].instrument_namestringrequired Instrument name |
Example
{request_example_shell}{request_example_javascript}{request_example_python}The above command returns JSON structured like this:
{response_example_json}