Skip to content
UDX
2026-07-15
2026-07-15Latest
Esc
↑↓navigate↵open⌘Jpreview

List Account RFQs

Returns RFQs submitted from the specified authorized account, including submissions by other users. Terminal RFQs are retained for five minutes after their terminal update is received; older records are omitted.

GET/accounts/{account_id}/rfqs
Authorization
Authorization
UDX-Access-KeyAPI key · headerrequired

Opaque API key ID.

UDX-Access-TimestampAPI key · headerrequired

Unix time in milliseconds, within 30 seconds of server time.

UDX-Access-SignatureAPI key · headerrequired

Standard-base64 RSA-PSS/SHA-256 signature with a 32-byte salt.

or
AuthorizationBearer token (JWT) · headerrequired

Bearer token for an active signed-in UDX user.

Header parameters
Header parameters
UDX-Versionstring

Dated API version (YYYY-MM-DD).

min length 10 · max length 10
Path parameters
account_idEntityIdrequired

The account you are authorized to read.

min length 1
Query parameters
client_rfq_idClientId

Filter by the correlation identifier supplied when creating the RFQ.

tickerTicker

Filter by market ticker (single-leg RFQs).

min length 1 · max length 128
statusRfqStatus[]

Filter by one or more statuses.

min items 1 · max items 4
limitinteger

Page size.

min 1 · max 1000 · default: 10
pagestring

Opaque token identifying the requested page.

max length 512
Responses
200A page of RFQs submitted from the account.
rfqsRfq[]required

One page of RFQs.

max items 100
Show properties
Array of Rfq
rfq_idstring

Present on every RFQ except one the exchange rejected before assigning an id; such an RFQ is identified by client_rfq_id alone.

min length 1
requester_idstring

The participant identifier of the user who created this RFQ.

min length 1 · max length 64
client_rfq_idstring

The requester's correlation identifier for this RFQ. Present only on RFQs created by the caller's member.

legsRfqLegListrequired

The component markets and opposing sides that define the RFQ strategy, in the order supplied.

min items 1
Show properties
Array of RfqLeg
tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128
opposing_sideboolean

Whether this leg takes the side opposite the RFQ or the same side.

default: false
sidestring

The side the customer wants to execute. Absent for a two-sided RFQ.

Allowed:buysell
quantitystring

Number of contracts requested. Present when sized in contracts.

max length 24 · matches ^[0-9]+(\.[0-9]{1,2})?$
cash_quantitystring

Size of the RFQ in dollars. Present when sized in cash.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$
statusRfqStatusrequired

An RFQ's status.

Allowed:openacceptedclosedrejected
rejection_reasonstring

Why the exchange rejected the RFQ. Present only when status is rejected.

Allowed:market_closedmarket_unknownnot_open_for_quotingexpiredduplicate_client_idexchange_rejected
expires_atstring<date-time>

When the RFQ stops soliciting quotes.

max length 40
next_page_urlNextPageURL | nullrequired

Root-relative URL for the next page. Null when there are no more items.

max length 4096 · matches ^/[^/\s#][^\s#]*$
400The request doesn't conform to this spec.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
401No valid credential was provided.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
403The credential lacks the read scope.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
429The member rate limit was exceeded.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
500Something went wrong on UDX's side.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
503Request admission or account setup is unavailable, or the read could not be completed in time; retry.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
Request
curl -X GET "https://api.underdogexchange.com/accounts/6820943174116859281/rfqs" \
  -H "UDX-Access-Key: API_KEY_ID" \
  -H "UDX-Access-Timestamp: UNIX_MILLISECONDS" \
  -H "UDX-Access-Signature: BASE64_SIGNATURE"
Response
{
  "rfqs": [
    {
      "rfq_id": "BKA2QM3T4055",
      "requester_id": "4d127cce3bc675c9",
      "client_rfq_id": "rfq-20260804-001",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET",
          "opposing_side": false
        }
      ],
      "side": "buy",
      "quantity": "100",
      "status": "open",
      "expires_at": "2026-01-01T00:01:00.000000Z"
    },
    {
      "rfq_id": "BKA2QM3T4099",
      "requester_id": "9a51f00d21be44c7",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET",
          "opposing_side": false
        }
      ],
      "side": "sell",
      "quantity": "250",
      "status": "open",
      "expires_at": "2026-01-01T00:01:30.000000Z"
    }
  ],
  "next_page_url": null
}