Options Trading

Options strategies depend on contract-level metadata and lifecycle awareness.

get_active_option_positions

Example Request
Example Response
{
  "clientAddress": "0xF4614C8C45beF5700e491E627aeecd4d5aabac61"
}
{
  "clientAddress": "0xF4614C8C45beF5700e491E627aeecd4d5aabac61",
  "positions": [
    {
      "positionId": "opt_pos_441209",
      "underlying": "ETH",
      "optionType": "call",
      "side": "long",
      "expiryDate": "2025-01-14T11:05:44Z",
      "contracts": "2",
      "premiumPaid": "180.00",
      "usdFeePaid": "0.01",
      "markPrice": "125.50",
      "strikePrice": "3500",
      "takeProfitPrice": "160.00",
      "stopLossPrice": "90.00",
      "usdUnrealisedPnl": "71.00",
      "openedAt": "2025-01-14T11:05:44Z"
    }
  ],
  "lastUpdatedAt": "2025-01-14T11:05:44Z"
}

get_historical_option_positions

Example Request
Example Response
{
  "clientAddress": "0xF4614C8C45beF5700e491E627aeecd4d5aabac61"
}
{
  "clientAddress": "0xF4614C8C45beF5700e491E627aeecd4d5aabac61",
  "positions": [
    {
      "positionId": "opt_pos_431876",
      "underlying": "ETH",
      "optionType": "put",
      "side": "long",
      "strikePrice": "3200",
      "expiryDate": "2025-01-14T11:05:44Z",
      "contracts": "1",
      "premiumPaid": "95.00",
      "usdFeePaid": "0.01",
      "takeProfitPrice": "140.00",
      "stopLossPrice": "60.00",
      "settlementPrice": "3100.00",
      "usdRealisedPnl": "105.00",
      "closeReason": "expired_in_the_money",
      "openedAt": "2025-01-14T11:05:44Z",
      "closedAt": "2025-01-14T11:05:44Z"
    }
  ]
}

get_option_chain

Example Request
Example Response
{
  "underlying": "ETH",
  "expiryDate": "31 Jan 2025"
}
{
  "underlying": "ETH",
  "expiryDate": "2025-01-14T11:05:44Z",
  "options": [
    {
      "optionType": "call",
      "strikePrice": "3400",
      "markPrice": "165.00",
      "openInterest": "1240",
      "volume24h": "310"
    },
    {
      "optionType": "call",
      "strikePrice": "3500",
      "markPrice": "118.00",
      "openInterest": "980",
      "volume24h": "275"
    },
    {
      "optionType": "put",
      "strikePrice": "3200",
      "markPrice": "105.00",
      "openInterest": "1125",
      "volume24h": "290"
    }
  ],
  "lastUpdatedAt": "2025-01-14T11:05:44Z"
}

get_expiry_schedule

Example Request
Example Response
{
  "underlying": "ETH"
}
{
  "underlying": "ETH",
  "expiries": [
    "2025-01-14T11:05:44Z",
    "2025-04-14T11:07:44Z",
    "2025-05-14T11:20:44Z",
    "2025-09-14T11:45:44Z"
  ],
  "lastUpdatedAt": "2025-01-14T11:05:44Z"
}

get_greeks (optional)

Returns option sensitivity metrics for a specific contract. Supports delta-neutral or volatility-based strategies.

Example Request
Example Response
{
  "underlying": "ETH",
  "optionType": "call",
  "strikePrice": "3500",
  "expiryDate": "31 Jan 2025"
}
{
  "underlying": "ETH",
  "optionType": "call",
  "strikePrice": "3500",
  "expiryDate": "2025-01-14T11:05:44Z",
  "delta": "0.48",
  "gamma": "0.0021",
  "theta": "-12.5",
  "vega": "18.4",
  "impliedVolatility": "62.3%",
  "lastUpdatedAt": "2025-01-14T11:05:44Z"
}

Last updated