Trading 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

api

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

Show Instrument properties

symbol

string

Unique trading symbol identifier

baseAsset

string

Base asset being traded (e.g., US500, US100, GOLD, OIL)

quoteAsset

string

Quote asset for pricing (always BTC)

description

string

Human-readable description of the instrument

min_order_size

integer

Minimum order size in satoshis

max_order_size

integer

Maximum order size in satoshis

tickSize

integer

Minimum price increment in satoshis

contractSize

number

Size of one contract in base asset units

settlementCurrency

string

Currency used for settlement (always BTC)

marginRequirement

number

Initial margin requirement as decimal (e.g., 0.10 = 10%)

makerFee

number

Fee rate for maker orders as decimal

takerFee

number

Fee rate for taker orders as decimal

fundingInterval

string

Funding payment interval (e.g., “8h”)

maxLeverage

integer

Maximum allowed leverage for this instrument

tradingHours

object

Trading session times

Show Trading hours properties

start

string

Daily session start time (HH:mm:ss)

end

string

Daily session end time (HH:mm:ss)

timezone

string

Timezone for trading hours (always UTC)

launchDate

string

ISO 8601 date when instrument was launched

expiryDate

string | null

ISO 8601 expiry date (null for perpetual contracts)

Understanding Trading Instruments

Available 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).

Contract Specifications

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

Size and Pricing

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%

Fee Structure

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.

Order Book

Current market depth

Trading Calendars

Trading schedule information

Insurance Fund Trading Calendars

⌘I

Overview

Getting Started

Market Data

Order Management

Account & Portfolio

Positions

Trading Instruments

Get Trading Instruments

Endpoint

Parameters

Example Request

Response

Understanding Trading Instruments

Order Book

Trading Calendars

Overview

Getting Started

Market Data

Order Management

Account & Portfolio

Positions

​Get Trading Instruments

​Endpoint

​Parameters

​Example Request

​Response

​Understanding Trading Instruments

Order Book

Trading Calendars

Get Trading Instruments

Endpoint

Parameters

Example Request

Response

Understanding Trading Instruments