Skip to main content
GET
TypeScript

Authorizations

Authorization
string
header
required

The Trading API key (trdrs_sk_…), for market data, orders and account state on the accounts its owner holds. Use it server-to-server, and keep it on your server. Its scope is named trading in the API.

Query Parameters

provider
string

The provider the account is at, such as rithmic or paper. Omit it to use your default provider. An unknown value is refused with 400, never replaced with another provider.

account
string

The account number at that provider. It must be one of your own accounts, or the call is refused with 400.

Response

The markets. They depend on the account:

  • An account at an exchange (Hyperliquid, Binance, Bybit) trades the exchange's own perpetuals. Another exchange's perpetual is that exchange's market, on its own contract terms, so it isn't listed.
  • An account at a futures provider (Rithmic, Tastytrade) trades the futures products trdrs holds a contract specification for, as continuous futures (ES1!) and as dated contracts. A Rithmic continuous future names the contract its position trades now, by the product's roll rule. Tastytrade names its own active month, which GET /api/trading/match answers, so its front continuous future lists with contract null. A Rithmic login at a venue's system lists the same markets under the login's brand, and Rithmic refuses at order time what the venue doesn't permit.
  • An account on the paper book (a Demo or an account a venue issued) and an account a venue granted at a provider trade what the venue's catalog lists for the account and it can enter now. A dated contract is listed until its last trade, and the continuous futures are the listed contracts of each product in roll order, each trading as its contract until the front one rolls.
  • The paper book prices futures only from the trader's own futures source, a login on their venue's production Rithmic system, so it lists futures only for a trader who has one.
  • A CFD is listed only while a provider serves its price, and its exchange names that provider.

scope names whose markets they are: the venue that issued the account, the brand of a login at a venue's system (Apex on Rithmic), or else the provider. A Demo has none. When the account stream's trading event carries another fingerprint, the list changed, so read it again.

Every market the account can enter now, by the same judgment its orders meet.

account
string
required

The account number the markets are for.

scope
object | null
required

Whose markets they are, or null for a trader's own Demo, which trades every market on the paper book.

Example:
fingerprint
string
required

Changes whenever the list does. The account stream's trading event carries it, so read the list again only when it changes.

markets
object[]
required

The markets.