Instruments

GET

https://api.onetrading.com/fast/v1/instruments

Retrieves a list of available instrument pairs on the exchange, including details about the base and quote assets, precision levels, minimum and maximum trading limits, and the current market type. The response provides key information needed for trading, such as instrument unique IDs, pricing, and state (ACTIVE or otherwise). Optionally, the results can be filtered by market type using the type query parameter.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.onetrading.com/fast/v1/instruments?type'

Response Example

[
    {
        "base": {
            "code": "BTC",
            "precision": 5
        },
        "quote": {
            "code": "USDT",
            "precision": 2
        },
        "amount_precision": 5,
        "market_precision": 2,
        "min_size": "10.0",
        "min_price": "1000",
        "max_price": "10000000",
        "id": "BTC_USDT",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "BTC",
            "precision": 5
        },
        "quote": {
            "code": "EUR",
            "precision": 2
        },
        "amount_precision": 5,
        "market_precision": 2,
        "min_size": "10.0",
        "min_price": "1000",
        "max_price": "10000000",
        "id": "BTC_EUR",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "ETH",
            "precision": 4
        },
        "quote": {
            "code": "USDT",
            "precision": 2
        },
        "amount_precision": 4,
        "market_precision": 2,
        "min_size": "10.0",
        "min_price": "100",
        "max_price": "10000000",
        "id": "ETH_USDT",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "ETH",
            "precision": 4
        },
        "quote": {
            "code": "EUR",
            "precision": 2
        },
        "amount_precision": 4,
        "market_precision": 2,
        "min_size": "10.0",
        "min_price": "10",
        "max_price": "10000000",
        "id": "ETH_EUR",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "ETH",
            "precision": 3
        },
        "quote": {
            "code": "BTC",
            "precision": 5
        },
        "amount_precision": 3,
        "market_precision": 5,
        "min_size": "0.00022",
        "min_price": "0.0001",
        "max_price": "10000",
        "id": "ETH_BTC",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "USDT",
            "precision": 5
        },
        "quote": {
            "code": "EUR",
            "precision": 2
        },
        "amount_precision": 2,
        "market_precision": 5,
        "min_size": "1.0",
        "min_price": "0.1",
        "max_price": "10",
        "id": "USDT_EUR",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "XRP",
            "precision": 4
        },
        "quote": {
            "code": "EUR",
            "precision": 2
        },
        "amount_precision": 3,
        "market_precision": 4,
        "min_size": "10.0",
        "min_price": "0.0001",
        "max_price": "1000",
        "id": "XRP_EUR",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "XRP",
            "precision": 4
        },
        "quote": {
            "code": "USDT",
            "precision": 2
        },
        "amount_precision": 3,
        "market_precision": 4,
        "min_size": "10.0",
        "min_price": "0.0001",
        "max_price": "1000",
        "id": "XRP_USDT",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "SOL",
            "precision": 4
        },
        "quote": {
            "code": "EUR",
            "precision": 2
        },
        "amount_precision": 4,
        "market_precision": 3,
        "min_size": "10.0",
        "min_price": "0.01",
        "max_price": "1000000",
        "id": "SOL_EUR",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "SOL",
            "precision": 4
        },
        "quote": {
            "code": "USDT",
            "precision": 2
        },
        "amount_precision": 4,
        "market_precision": 3,
        "min_size": "10.0",
        "min_price": "0.01",
        "max_price": "1000000",
        "id": "SOL_USDT",
        "type": "SPOT",
        "state": "ACTIVE"
    },
    {
        "base": {
            "code": "BTC",
            "precision": 5
        },
        "quote": {
            "code": "EUR",
            "precision": 2
        },
        "amount_precision": 5,
        "market_precision": 2,
        "min_size": "10.0",
        "min_price": "1000",
        "max_price": "10000000",
        "id": "BTC_EUR_P",
        "type": "PERP",
        "state": "ACTIVE"
    }
]

Request

Query Params

type

enum<string>

optional

Filters the instrument pairs by market type; valid values are SPOT for spot markets and PERP for perpetual futures.

Allowed values:

SPOTPERP

Responses

🟢200Success

application/json

Body

array of:

base

object

required

An object representing the base asset in the trading pair.

code

string

required

The symbol for the base asset (e.g., BTC).

precision

integer

required

The number of decimal places allowed for the base asset.

quote

object

required

An object representing the quote asset in the trading pair.

code

string

required

The symbol for the quote asset (e.g., EUR).

precision

integer

required

The number of decimal places allowed for the quote asset.

amount_precision

integer

required

The number of decimal places allowed when specifying the trade amount (quantity of the base asset).

market_precision

integer

required

The number of decimal places allowed when specifying the price of the instrument.

min_size

string

required

The minimum allowable order value for the instrument, expressed in the quote asset (e.g., 10 EUR or 10 USDT). This is calculated as price × amount and ensures the order meets the required notional value.

min_price

string

required

The minimum allowable price for the instrument, expressed in the quote asset.

max_price

string

required

The maximum allowable price for the instrument, expressed in the quote asset.

string

required

he unique identifier for the trading pair (e.g., BTC_USDT). This is used when creating / cancelling orders as instrument_code.

type

enum<string>

required

The type of market for the instrument (e.g., SPOT for spot markets or PERP for perpetual futures).

Allowed values:

SPOTPERP

state

enum<string>

required

The current state of the instrument, indicating whether it is ACTIVE (tradable) or not.

Allowed values:

ACTIVESUSPENDEDPOST_ONLYCLOSED

Currencies

Candlesticks