GET
/
api
/
v1
/
market
/
instruments
curl -X GET "https://api.roxom.com/api/v1/market/instruments?tradeable=true&unit=btc"
{
  "data": [
    {
      "symbol": "US500-BTC",
      "baseAsset": "US500",
      "quoteAsset": "BTC",
      "description": "S&P 500 Index futures settled in Bitcoin",
      "status": "active",
      "min_order_size": 100000,
      "max_order_size": 100000000000,
      "tickSize": 1,
      "contractSize": 1,
      "settlementCurrency": "BTC",
      "marginRequirement": 0.10,
      "makerFee": 0.0002,
      "takerFee": 0.0005,
      "fundingInterval": "8h",
      "maxLeverage": 10,
      "tradingHours": {
        "start": "00:00:00",
        "end": "23:59:59",
        "timezone": "UTC"
      },
      "launchDate": "2024-01-01T00:00:00Z",
      "expiryDate": null
    },
    {
      "symbol": "GOLD-BTC",
      "baseAsset": "GOLD",
      "quoteAsset": "BTC", 
      "description": "Gold ETF futures settled in Bitcoin",
      "status": "active",
      "min_order_size": 50000,
      "max_order_size": 50000000000,
      "tickSize": 1,
      "contractSize": 1,
      "settlementCurrency": "BTC",
      "marginRequirement": 0.08,
      "makerFee": 0.0002,
      "takerFee": 0.0005,
      "fundingInterval": "8h",
      "maxLeverage": 12,
      "tradingHours": {
        "start": "00:00:00",
        "end": "23:59:59",
        "timezone": "UTC"
      },
      "launchDate": "2024-01-01T00:00:00Z",
      "expiryDate": null
    },
    {
      "symbol": "OIL-BTC",
      "baseAsset": "OIL",
      "quoteAsset": "BTC",
      "description": "Crude Oil futures settled in Bitcoin",
      "status": "active",
      "min_order_size": 25000,
      "max_order_size": 25000000000,
      "tickSize": 1,
      "contractSize": 1,
      "settlementCurrency": "BTC",
      "marginRequirement": 0.12,
      "makerFee": 0.0003,
      "takerFee": 0.0006,
      "fundingInterval": "8h",
      "maxLeverage": 8,
      "tradingHours": {
        "start": "00:00:00",
        "end": "23:59:59",
        "timezone": "UTC"
      },
      "launchDate": "2024-01-01T00:00:00Z",
      "expiryDate": null
    },
    {
      "symbol": "US100-BTC",
      "baseAsset": "US100",
      "quoteAsset": "BTC",
      "description": "NASDAQ 100 Index futures settled in Bitcoin",
      "status": "active",
      "min_order_size": 100000,
      "max_order_size": 100000000000,
      "tickSize": 1,
      "contractSize": 1,
      "settlementCurrency": "BTC",
      "marginRequirement": 0.10,
      "makerFee": 0.0002,
      "takerFee": 0.0005,
      "fundingInterval": "8h",
      "maxLeverage": 10,
      "tradingHours": {
        "start": "00:00:00",
        "end": "23:59:59",
        "timezone": "UTC"
      },
      "launchDate": "2024-01-01T00:00:00Z",
      "expiryDate": null
    }
  ],
  "timestamp": "2024-01-15T10:30:00Z",
  "requestId": "req_abc123"
}

Get Trading Instruments

Retrieve information about all available trading instruments, including contract specifications and trading rules.

Endpoint

GET /api/v1/market/instruments

Parameters

tradeable
boolean
default:"true"
Filter to only tradeable instruments
unit
string
default:"btc"
Units for response values: “sats” or “btc”

Example Request

curl -X GET "https://api.roxom.com/api/v1/market/instruments?tradeable=true&unit=btc"

Response

{
  "data": [
    {
      "symbol": "US500-BTC",
      "baseAsset": "US500",
      "quoteAsset": "BTC",
      "description": "S&P 500 Index futures settled in Bitcoin",
      "status": "active",
      "min_order_size": 100000,
      "max_order_size": 100000000000,
      "tickSize": 1,
      "contractSize": 1,
      "settlementCurrency": "BTC",
      "marginRequirement": 0.10,
      "makerFee": 0.0002,
      "takerFee": 0.0005,
      "fundingInterval": "8h",
      "maxLeverage": 10,
      "tradingHours": {
        "start": "00:00:00",
        "end": "23:59:59",
        "timezone": "UTC"
      },
      "launchDate": "2024-01-01T00:00:00Z",
      "expiryDate": null
    },
    {
      "symbol": "GOLD-BTC",
      "baseAsset": "GOLD",
      "quoteAsset": "BTC", 
      "description": "Gold ETF futures settled in Bitcoin",
      "status": "active",
      "min_order_size": 50000,
      "max_order_size": 50000000000,
      "tickSize": 1,
      "contractSize": 1,
      "settlementCurrency": "BTC",
      "marginRequirement": 0.08,
      "makerFee": 0.0002,
      "takerFee": 0.0005,
      "fundingInterval": "8h",
      "maxLeverage": 12,
      "tradingHours": {
        "start": "00:00:00",
        "end": "23:59:59",
        "timezone": "UTC"
      },
      "launchDate": "2024-01-01T00:00:00Z",
      "expiryDate": null
    },
    {
      "symbol": "OIL-BTC",
      "baseAsset": "OIL",
      "quoteAsset": "BTC",
      "description": "Crude Oil futures settled in Bitcoin",
      "status": "active",
      "min_order_size": 25000,
      "max_order_size": 25000000000,
      "tickSize": 1,
      "contractSize": 1,
      "settlementCurrency": "BTC",
      "marginRequirement": 0.12,
      "makerFee": 0.0003,
      "takerFee": 0.0006,
      "fundingInterval": "8h",
      "maxLeverage": 8,
      "tradingHours": {
        "start": "00:00:00",
        "end": "23:59:59",
        "timezone": "UTC"
      },
      "launchDate": "2024-01-01T00:00:00Z",
      "expiryDate": null
    },
    {
      "symbol": "US100-BTC",
      "baseAsset": "US100",
      "quoteAsset": "BTC",
      "description": "NASDAQ 100 Index futures settled in Bitcoin",
      "status": "active",
      "min_order_size": 100000,
      "max_order_size": 100000000000,
      "tickSize": 1,
      "contractSize": 1,
      "settlementCurrency": "BTC",
      "marginRequirement": 0.10,
      "makerFee": 0.0002,
      "takerFee": 0.0005,
      "fundingInterval": "8h",
      "maxLeverage": 10,
      "tradingHours": {
        "start": "00:00:00",
        "end": "23:59:59",
        "timezone": "UTC"
      },
      "launchDate": "2024-01-01T00:00:00Z",
      "expiryDate": null
    }
  ],
  "timestamp": "2024-01-15T10:30:00Z",
  "requestId": "req_abc123"
}
data
array
Array of trading instrument specifications

Understanding Trading Instruments

Use this endpoint to check current trading rules and specifications before placing orders, as parameters may be updated periodically.