Skip to main content

REST API Settings - Get markets

Get markets

Written by Albert
Updated over 2 weeks ago

Get markets

GET /frontoffice/api/v5/markets

Summary

Use this method to retrieve detailed information about available markets including trading sessions, funding intervals, and market specifications.

Request

Query parameters

categoryId

The market category identifier.

dynamicCommissionGroupId

The dynamic commission group identifier.

Request example

GET /frontoffice/api/v5/markets HTTP/1.1
Host: {host}
Authorization: Bearer JWT
Accept: */*

Response

In case of success, an array of market objects will be returned.

Each market object contains the following information:

marketId string

The market identifier, in the following format: {marketType}.{baseAssetId}_{quoteAssetId}, for example: cfd.eth_eur.

displayName string

The market ticker.

fullName string | nullable

The market full name or description (optional).

type string

The market type.

Possible values:

  • Spot

  • Cfd

  • Perp

subtype string | nullable

Applicable to CFD markets only.

The market subtype.

Possible values:

  • Crypto

  • Fx

  • Metals

  • Indices

  • Energies

  • Ndf

  • Shares

  • Etf

Response example β€” 200: OK

[
{
"marketId": "spot.btc_usdt",
"displayName": "BTC/USDT",
"fullName": null,
"type": "Spot",
"subtype": null
},
{
"marketId": "cfd.eth_btc",
"displayName": "ETH/BTC",
"fullName": "Ethereum to Bitcoin",
"type": "Cfd",
"subtype": "Crypto"
},
{
"marketId": "perp.trx_usdt",
"displayName": "TRX/USDT",
"fullName": "TRX to Tether Perpetual",
"type": "Perpetual",
"subtype": null
}
]

Did this answer your question?