instruments: Get instruments

API: okx.com:okx-api
Endpoint: /public/instruments
Response format: application/json
Auth: unknown
Method: GET
Last Status: 200
Latency: 510ms

Description

Returns metadata about all available trading instruments including base/quote currencies, minimum order sizes (lotSz), price increments (tickSz), and maximum order limits. Essential for building valid orders.

From spec: Retrieve a list of available trading instruments/pairs.

Usage Tips

- Required parameter: instType (SPOT, MARGIN, SWAP, FUTURES, OPTION) - Optional: instId to filter specific instrument - Use before placing orders to validate lot sizes and tick sizes - Contains critical fields: lotSz (min order size), tickSz (price increment), minSz (minimum size)

Parameters (4)

instFamily (string, query, optional)

Instrument family (e.g., BTC-USD). Required for OPTION

instId (string, query, optional)

Specific instrument ID to query

instType (string, query, required)

Instrument type (SPOT, MARGIN, SWAP, FUTURES, OPTION)

Constraints: {'enum': ['SPOT', 'MARGIN', 'SWAP', 'FUTURES', 'OPTION']}

uly (string, query, optional)

Underlying and quote currency (e.g., BTC-USD). Deprecated

Examples (1)

Get SPOT trading instruments metadata probe-gate

Demonstrates fetching instrument metadata for SPOT pairs including trading rules, lot sizes, tick sizes, and other configuration required for order placement.

curl 'https://www.okx.com/api/v5/public/instruments?instType=SPOT'
import requests

resp = requests.get(
    "https://www.okx.com/api/v5/public/instruments",
    params={
        'instType': 'SPOT',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("okx")
result = api.fetch("public/instruments", instType="SPOT")

for item in result:
    print(item)
const resp = await fetch("https://www.okx.com/api/v5/public/instruments?instType=SPOT");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:09:06.640234 200 510ms
2026-04-16 02:30:43.657118 200 340ms
2026-04-15 01:03:28.933357 200 355ms
2026-04-14 00:06:17.080676 200 561ms
2026-04-12 13:53:07.849914 200 430ms
2026-04-10 00:54:45.516130 200 270ms
2026-04-09 02:27:00.704989 200 341ms