List Instruments

List available trading instruments.

Endpoint

GET /api/v3/market/instrument/list

Description

Returns a paginated list of available trading instruments (trading pairs). Instruments can be filtered by venue, symbol, security type, and status.

Authentication

Requires Bearer token authentication.

Authorization: Bearer {access_token}

Request Parameters

Parameter	Type	Required	Description
venue	string	No	Filter by venue (e.g., BINANCE)
symbols	string	No	Filter by symbols (comma-separated)
securityType	string	No	Filter by security type (e.g., SPOT, PERPETUAL)
status	string	No	Filter by status (ACTIVE, INACTIVE)
limit	integer	No	Maximum results (default: 10, max: 100)
offset	integer	No	Number of results to skip

Response

Returns an array of instrument objects with pagination.

Instrument Object

Field	Type	Description
instrumentId	string	Unique instrument identifier (format: VENUE:BASE/QUOTE)
venue	string	Venue identifier
symbol	string	Trading pair symbol (e.g., BTC/USDT)
baseAsset	string	Base asset (e.g., BTC)
quoteAsset	string	Quote asset (e.g., USDT)
securityType	string	Security type (SPOT, PERPETUAL, etc.)
status	string	Instrument status
pricePrecision	integer	Price decimal precision
quantityPrecision	integer	Quantity decimal precision
minQuantity	string	Minimum order quantity
maxQuantity	string	Maximum order quantity
minNotional	string	Minimum order notional value

Usage

import requests

headers = {"Authorization": f"Bearer {access_token}"}

# List all Binance instruments
response = requests.get(
    "https://cadenza-api-uat.algo724.com/api/v3/market/instrument/list",
    headers=headers,
    params={"venue": "BINANCE", "limit": 20}
)

instruments = response.json()["data"]
for inst in instruments:
    print(f"{inst['instrumentId']}: {inst['baseAsset']}/{inst['quoteAsset']}")

curl "https://cadenza-api-uat.algo724.com/api/v3/market/instrument/list?venue=BINANCE&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Example Response

{
  "data": [
    {
      "instrumentId": "BINANCE:BTC/USDT",
      "venue": "BINANCE",
      "symbol": "BTC/USDT",
      "baseAsset": "BTC",
      "quoteAsset": "USDT",
      "securityType": "SPOT",
      "status": "ACTIVE",
      "pricePrecision": 2,
      "quantityPrecision": 6,
      "minQuantity": "0.00001",
      "maxQuantity": "9000",
      "minNotional": "10"
    },
    {
      "instrumentId": "BINANCE:ETH/USDT",
      "venue": "BINANCE",
      "symbol": "ETH/USDT",
      "baseAsset": "ETH",
      "quoteAsset": "USDT",
      "securityType": "SPOT",
      "status": "ACTIVE",
      "pricePrecision": 2,
      "quantityPrecision": 5,
      "minQuantity": "0.0001",
      "maxQuantity": "9000",
      "minNotional": "10"
    }
  ],
  "success": true,
  "errno": 0,
  "error": null,
  "pagination": {
    "offset": 0,
    "limit": 10,
    "total": 500
  }
}

Error Responses

HTTP Code	Error	Description
400	Invalid request	Invalid venue or parameter
401	Unauthorized	Invalid or expired access token

Notes

• The instrumentId is used in other API calls to reference specific instruments
• Use the precision fields to format prices and quantities correctly
• Check minQuantity, maxQuantity, and minNotional before placing orders
• Use pagination for large result sets