List Instruments

Returns the list of tradeable instruments, optionally filtered by base currency, instrument kind, and expiration status. This endpoint is public — no authentication is required.

Filter semantics:

• currency filters by the base currency of the instrument’s currency pair (case-insensitive match).
• kind filters by instrument type (case-insensitive match against the kind value enum).
• expired = true returns only instruments whose expiration_timestamp is in the past; expired = false returns only non-expired instruments. Omit the parameter to get both.

List Instruments

cURL

curl --request GET \
  --url https://195.138.37.5:4410/api/v2/public/get_instruments

import requests

url = "https://195.138.37.5:4410/api/v2/public/get_instruments"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://195.138.37.5:4410/api/v2/public/get_instruments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "4410",
  CURLOPT_URL => "https://195.138.37.5:4410/api/v2/public/get_instruments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://195.138.37.5:4410/api/v2/public/get_instruments"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://195.138.37.5:4410/api/v2/public/get_instruments")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://195.138.37.5:4410/api/v2/public/get_instruments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "instrument_id": 124942,
      "instrument_name": "ETH-PERPETUAL",
      "kind": "perp_future",
      "product_group": "ETH",
      "base_currency": "ETH",
      "quote_currency": "USDC",
      "settlement_currency": "USDC",
      "tick_size": 0.01,
      "is_active": true,
      "creation_timestamp": 1747500000000
    },
    {
      "instrument_id": 200001,
      "instrument_name": "BTC-30MAY26-70000-C",
      "kind": "option",
      "product_group": "BTC",
      "base_currency": "BTC",
      "quote_currency": "USDC",
      "settlement_currency": "USDC",
      "tick_size": 0.5,
      "strike": 70000,
      "option_type": "call",
      "is_active": true,
      "expiration_timestamp": 1779148800000,
      "creation_timestamp": 1748400000000
    }
  ]
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": 123,
    "message": "<string>",
    "data": "<unknown>"
  },
  "id": 123
}

Query Parameters

currency · string

Filter by the base currency of the instrument's currency pair (e.g. BTC, ETH, AVAX). Case-insensitive.

kind · enum<string>

Filter by instrument kind. Case-insensitive.

Available options: perp_future, option, spot, future_combo, option_combo, dated_future

expired · boolean

When true, return only expired instruments. When false, return only currently-active (non-expired) instruments. Omit to return both.

Response

200

application/json

List of instruments matching the supplied filters.

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object[] · required

Array of instruments matching the supplied filters. May be empty.

Hide child attributes

result. instrument_id · integer<int64> · required

Stable numeric identifier for the instrument.

Example:

124942

result. instrument_name · string · required

Human-readable instrument symbol (e.g. ETH-PERPETUAL, BTC-30MAY26-70000-C).

Example:

"ETH-PERPETUAL"

result. kind · enum<string> · required

Instrument category.

Available options: perp_future, option, spot, future_combo, option_combo, dated_future

result. is_active · boolean · required

Whether the instrument is currently enabled for trading.

result. product_group · string | null

Product grouping resolved from the base symbol of the instrument's currency pair.

Example:

"ETH"

result. base_currency · string | null

Base currency of the instrument's currency pair.

Example:

"ETH"

result. quote_currency · string | null

Quote currency of the instrument's currency pair.

Example:

"USDC"

result. settlement_currency · string | null

Settlement currency for the instrument. Currently equal to quote_currency.

Example:

"USDC"

result. tick_size · number

Minimum price increment for the instrument.

Example:

0.01

result. strike · number | null

Strike price (options only). null for non-option instruments.

Example:

70000

result. option_type · enum<string> | null

Option type (options only). null for non-option instruments.

Available options: call, put

result. expiration_timestamp · integer<int64> | null

Instrument expiration time in milliseconds since the Unix epoch. null for perpetuals and other non-expiring instruments.

Example:

1779148800000

result. creation_timestamp · integer<int64> | null

Instrument creation/listing time in milliseconds since the Unix epoch.

Example:

1747500000000

result. min_trade_amount · number | null

Minimum allowed order quantity. May be null if not yet populated.

result. contract_size · number | null

Contract size for the instrument. May be null if not yet populated.

result. settlement_period · string | null

Settlement period descriptor. May be null if not yet populated.

result. maker_commission · number | null

Maker commission rate. May be null if not yet populated.

result. taker_commission · number | null

Taker commission rate. May be null if not yet populated.

result. block_trade_commission · number | null

Block trade commission rate. May be null if not yet populated.

id · integer

The id that was sent in the request