Rfqs

List RFQs

Changed on

Lists the authenticated account's RFQs, most recent first.

This is a synchronous read from the RFQ venue. It returns one page of RFQs (up to 100 by default, sized via page_size), optionally filtered by state. The page is built from the RFQs the venue holds for the account and every account sharing its RFQ registration, of which only the authenticated account's are returned — a busy set of related accounts can therefore leave a page short. The response's next field carries the venue's cursor to the following page; pass it back as cursor to continue, and stop only when it is null — an empty results with a non-null next is normal, since the cursor tracks the venue's page, not this account's records. Each result includes the venue-issued RFQ identifier, lifecycle state, quantity, legs, counterparties, timestamps, and optional close reason. Venue state and close-reason strings are passed through. mark_price, when present, is the venue's structure mark at the moment the RFQ was created — the reference the taker was quoted against — recorded by Paradex at create. It is omitted when unknown: an RFQ created before that recording began, a structure the venue had not priced at create, or a mark past its retention. filled_quantity is the size that has settled: below quantity after a partial execution, and 0 for an RFQ that has not executed or is still settling. It is omitted while the venue does not report it.

get/rfqs

Request

  • Base URL
    https://api.prod.paradex.trade/v1
  • URL
    https://api.prod.paradex.trade/v1/rfqs
  • Auth
    API key in header Authorization

Query parameters

state'OPEN' | 'CLOSED'

RFQ state to filter by; omit for all states

cursorstring

Cursor from a prior response's next field; omit for the first (most recent) page

page_sizeinteger

Records per page, between 1 and 1000; omit for the default of 100

Response

OK

nextstring

Venue cursor to fetch the next page; null on the venue's last page. An empty results with a non-null next is normal — the venue paginates over the whole RFQ registration, of which only this account's records are returned — so continue until next is null rather than stopping on an empty page.

Example response

{
  "next": "cD0yMDIyLTAxLTAxKzAwJTNBMDA=",
  "results": [
    {
      "closed_reason": "EXPIRED",
      "created_at": 1640995200000,
      "expires_at": 1640995500000,
      "filled_quantity": "4",
      "id": "r_2abCdEfGhIjKlMnOpQrStUvWxYz",
      "legs": [
        {
          "market": "BTC-USD-PERP",
          "price": "50000",
          "ratio": "1"
        }
      ],
      "mark_price": "49.98",
      "quantity": "10"
    }
  ]
}

Changes

  • f33feb7333eaRevision changes
    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

  • 72c125c93c2bRevision changes
    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status