Octodamus Derivatives API

The Derivatives API from Octodamus — 16 operation(s) for derivatives.

GitHub OpenAPI

Operations 16

GET /v2/derivatives/facts Derivatives Facts #
GET /v2/derivatives/facts/preview Derivatives Facts Preview #
GET /v2/stocks/perp-facts Stock Perp Facts #
GET /v2/stocks/perp-facts/preview Stock Perp Facts Preview #
GET /v2/polymarket/odds Polymarket Odds #
GET /v2/polymarket/odds/preview Polymarket Odds Preview #
GET /v2/macro/facts Macro Facts #
GET /v2/macro/facts/preview Macro Facts Preview #
GET /v2/congress/trades Congress Trades #
GET /v2/congress/trades/preview Congress Trades Preview #
GET /v2/equity/fair-value Equity Fair Value #
GET /v2/equity/fair-value/preview Equity Fair Value Preview #
GET /v2/equity/basis Equity Basis #
GET /v2/equity/basis/preview Equity Basis Preview #
GET /v2/arcus/perp Arcus Perp #
GET /v2/arcus/perp/preview Arcus Perp Preview #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/octodamus-com:octodamus-com-derivatives-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

octodamus-com-derivatives-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OctoData Derivatives API
  description: AI-powered market intelligence by Octodamus (@octodamusai)
  contact:
    name: Octodamus
    url: https://octodamus.com/
    email: octodamusai@gmail.com
  version: 3.0.0
security: []
tags:
- name: Derivatives
paths:
  /v2/derivatives/facts:
    get:
      tags:
      - Derivatives
      summary: Derivatives Facts
      description: Deterministic cross-venue derivatives facts (funding, OI, long/short). $0.02 USDC.
      operationId: derivatives_facts_v2_derivatives_facts_get
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
          default: BTC
          title: Asset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
      security:
      - x402Payment: []
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        network: base
        asset: USDC
        payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
  /v2/derivatives/facts/preview:
    get:
      tags:
      - Derivatives
      summary: Derivatives Facts Preview
      operationId: derivatives_facts_preview_v2_derivatives_facts_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /v2/stocks/perp-facts:
    get:
      tags:
      - Derivatives
      summary: Stock Perp Facts
      description: Deterministic tokenized-equity / stock-perp facts (funding, OI, positioning). $0.02 USDC.
      operationId: stock_perp_facts_v2_stocks_perp_facts_get
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
          default: NVDA
          title: Ticker
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
      security:
      - x402Payment: []
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        network: base
        asset: USDC
        payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
  /v2/stocks/perp-facts/preview:
    get:
      tags:
      - Derivatives
      summary: Stock Perp Facts Preview
      operationId: stock_perp_facts_preview_v2_stocks_perp_facts_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /v2/polymarket/odds:
    get:
      tags:
      - Derivatives
      summary: Polymarket Odds
      description: Deterministic Polymarket crypto odds facts (normalized odds, liquidity, spread, resolution). $0.02 USDC.
      operationId: polymarket_odds_v2_polymarket_odds_get
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Asset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
      security:
      - x402Payment: []
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        network: base
        asset: USDC
        payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
  /v2/polymarket/odds/preview:
    get:
      tags:
      - Derivatives
      summary: Polymarket Odds Preview
      operationId: polymarket_odds_preview_v2_polymarket_odds_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /v2/macro/facts:
    get:
      tags:
      - Derivatives
      summary: Macro Facts
      description: Raw cross-asset macro reference numbers (yield curve, USD, SPX, VIX, M2). $0.02 USDC.
      operationId: macro_facts_v2_macro_facts_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '402':
          description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
      security:
      - x402Payment: []
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
          enum:
          - BTC
          - ETH
          - SOL
          default: BTC
        description: Optional asset focus (BTC, ETH, or SOL). Endpoints return full market coverage; this scopes the primary asset.
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        network: base
        asset: USDC
        payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
  /v2/macro/facts/preview:
    get:
      tags:
      - Derivatives
      summary: Macro Facts Preview
      operationId: macro_facts_preview_v2_macro_facts_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /v2/congress/trades:
    get:
      tags:
      - Derivatives
      summary: Congress Trades
      description: Structured congressional trade disclosures (who/ticker/direction/amount/date). $0.02 USDC.
      operationId: congress_trades_v2_congress_trades_get
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          default: 45
          title: Days
      - name: ticker
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Ticker
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
      security:
      - x402Payment: []
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        network: base
        asset: USDC
        payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
  /v2/congress/trades/preview:
    get:
      tags:
      - Derivatives
      summary: Congress Trades Preview
      operationId: congress_trades_preview_v2_congress_trades_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /v2/equity/fair-value:
    get:
      tags:
      - Derivatives
      summary: Equity Fair Value
      description: 24/7 index-implied fair value for a tokenized equity when the NYSE is closed. $0.02 USDC.
      operationId: equity_fair_value_v2_equity_fair_value_get
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
          default: NVDA
          title: Ticker
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
      security:
      - x402Payment: []
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        network: base
        asset: USDC
        payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
  /v2/equity/fair-value/preview:
    get:
      tags:
      - Derivatives
      summary: Equity Fair Value Preview
      operationId: equity_fair_value_preview_v2_equity_fair_value_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /v2/equity/basis:
    get:
      tags:
      - Derivatives
      summary: Equity Basis
      description: Premium/discount of a tokenized stock's Robinhood Chain price vs its fair value. $0.02 USDC.
      operationId: equity_basis_v2_equity_basis_get
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
          default: NVDA
          title: Ticker
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
      security:
      - x402Payment: []
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        network: base
        asset: USDC
        payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
  /v2/equity/basis/preview:
    get:
      tags:
      - Derivatives
      summary: Equity Basis Preview
      operationId: equity_basis_preview_v2_equity_basis_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /v2/arcus/perp:
    get:
      tags:
      - Derivatives
      summary: Arcus Perp
      description: 'Live Arcus (Robinhood Chain) perp facts: funding, OI, mark vs oracle, off-hours margin. $0.02 USDC.'
      operationId: arcus_perp_v2_arcus_perp_get
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
          default: NVDA
          title: Ticker
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
      security:
      - x402Payment: []
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        network: base
        asset: USDC
        payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
  /v2/arcus/perp/preview:
    get:
      tags:
      - Derivatives
      summary: Arcus Perp Preview
      operationId: arcus_perp_preview_v2_arcus_perp_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    x402Payment:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: x402 pay-per-call on Base. Sign an EIP-3009 USDC authorization and send as this header. No signup required. See api.octodamus.com/v2/demo for a free preview.
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-OctoData-Key
      description: Annual API key from api.octodamus.com/v1/signup (free Basic tier available).
x-discovery:
  protocols:
  - x402
  network: base