Luxor Documentation Hub Logo
Derivatives/API Documentation/V2

Get derivatives contracts

Returns a list of derivatives contracts for a specific currency type with optional filtering by status, side, and type.

GET
/v2/derivatives/contracts/{currency_type}

Authorization

authorization<token>

Use your API key here.

In: header

Path Parameters

currency_typeRequiredstring

Currency type for derivatives operations

Value in: "BTC" | "USD"

Query Parameters

statusstring

Filter by contract status

Default: "ALL"Value in: "ALL" | "ACTIVE" | "SETTLED"
sidestring

Filter by contract side

Default: "ALL"Value in: "ALL" | "BUY" | "SELL"
typestring

Filter by contract type

Default: "ALL"Value in: "ALL" | "STANDARD" | "UPFRONT"
pageinteger

Page number for pagination (1-based)

Default: 1Minimum: 1
page_sizeinteger

Number of items per page

Default: 50Minimum: 1Maximum: 100
curl -X GET "https://app.luxor.tech/api/v2/derivatives/contracts/BTC?status=ALL&side=ALL&type=ALL&page=1&page_size=50" \
  -H "authorization: <token>"

Default Response

{
  "contracts": [
    {
      "status": "ACTIVE",
      "side": "SELL",
      "denomination": "BTC",
      "type": "STANDARD",
      "start_date": "2025-07-17",
      "end_date": "2025-10-18",
      "unit_hashprice": 0.00005049,
      "daily_hashrate_ph": 20
    }
  ],
  "pagination": {
    "page_number": 1,
    "page_size": 1,
    "item_count": 0,
    "previous_page_url": null,
    "next_page_url": null
  }
}