Skip to main content
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

Roxom currently offers three main trading instruments:
  • US100-BTC: QQQ (Invesco Nasdaq-100 ETF) perpetual futures.
  • US500-BTC: SPY (SPDR S&P 500 ETF) perpetual futures.
  • GOLD-BTC: PAXG (Tokenized Gold) perpetual futures.
  • OIL-BTC: USO (United States Oil Fund) perpetual futures.
All instruments are settled in Bitcoin (BTC).
  • Perpetual Contracts: No expiry date, trade indefinitely
  • Bitcoin Settlement: All profits/losses in BTC
  • Funding Payments: Every 8 hours to maintain price peg
  • 24/7 Trading: Continuous trading with no market close
  • Minimum Sizes: Vary by instrument for optimal liquidity
  • Tick Sizes: 1 satoshi minimum price increment
  • Leverage: Up to 12x depending on instrument
  • Margin: Initial margin requirements 8-12%
  • Maker Fees: 0.02-0.03% for adding liquidity
  • Taker Fees: 0.05-0.06% for removing liquidity
  • Funding Fees: Variable based on market conditions
  • No Hidden Fees: Transparent fee structure
Use this endpoint to check current trading rules and specifications before placing orders, as parameters may be updated periodically.
I