Skip to main content
A combo is a user-defined instrument containing 2–50 legs. Each leg identifies an existing market symbol and whether the combo buys or sells that leg. Once open, a combo trades through the normal Orders API; an RFQ is optional and provides a price-discovery and paired order-submission workflow over the same order book. All calls use normal Retail API authentication at:

Endpoints

On the Retail API, Combo and RFQ creation share an additional edge rate limit of 10 requests per 10 seconds, enforced per API key and per IP.

Weekly creation limit

Each participant can create 3,000 new combo instruments per week across all accounts and both Retail and Institutional APIs. The quota resets Monday at 00:00 UTC (Sunday at 8:00 PM EDT or 7:00 PM EST). Returning an existing canonical combo does not consume this quota.

Create a Combo

POST /v1/combos accepts 2–50 unique legs:
Leg symbols must be open, tradable, supported instruments. Duplicate symbols and invalid combinations are rejected. Treat the combo symbol as opaque: existing combos use caoc-... and new combos use crossd-.... Within one product, a canonical set of legs always maps to the same symbol, so creating an existing combo returns that instrument.

Get a Combo

GET /v1/combos?symbol=caoc-... requires the exact combo symbol. The response contains a combos array; an unknown symbol returns an empty array. This endpoint does not paginate.

See Also

RFQ API

Create and manage combo RFQs and quotes

Authentication

Sign Retail API requests

Private WebSocket

Receive RFQ and quote lifecycle events