One Trading API
REST APIWebSocket API
REST APIWebSocket API
  1. Public
  • Public
    • Currencies
      GET
    • Instruments
      GET
    • Candlesticks
      GET
    • Fee Groups
      GET
    • Order Book
      GET
    • Market Ticker
      GET
    • Market Ticker For Instrument
      GET
    • Time
      GET
  • Trading
    • Balances
      GET
    • Fees
      GET
    • Get Orders
      GET
    • Create Order
      POST
    • Get Order by Order ID
      GET
    • Get Order by Client ID
      GET
    • Cancel All Orders
      DELETE
    • Cancel Order by Order ID
      DELETE
    • Cancel Order by Client ID
      DELETE
    • Get Trades for Order
      GET
    • Get Trades
      GET
    • Get Trade by Trade ID
      GET
  • Futures
    • Introduction
    • Funding Rate Methodology
    • Current Funding Rate
      GET
    • Funding Rate History
      GET
    • Futures Portfolio Summary
      GET
    • Get Futures Open Positions
      GET
  1. Public

Instruments

GET
https://api.onetrading.com/fast/v1/instruments
public
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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.onetrading.com/fast/v1/instruments?type'
Response 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.
id
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
Previous
Currencies
Next
Candlesticks
Built with