Bullish

Bullish Derivatives Public API

The derivatives-public API from Bullish — 3 operation(s) for derivatives-public.

GitHub OpenAPI

Operations 3

GET /v1/option-ladder Get Option Ladder by Base Symbol #
GET /v1/option-ladder/{symbol} Get Option Ladder by Symbol #
GET /v1/expiry-prices/{symbol} Get Expiry Prices #

Documentation

📖
Documentation
https://docs.exchange.bullish.com/rest/introduction
📖
APIReference
https://docs.exchange.bullish.com/rest/api/get-markets
📖
Authentication
https://docs.exchange.bullish.com/rest/authentication
📖
RateLimits
https://docs.exchange.bullish.com/rest/general/rate-limits

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bullish/refs/heads/main/openapi/bullish-derivatives-public-api-openapi.yml

Other Resources

🔗
ChangeLog
https://docs.exchange.bullish.com/rest/changelog

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/bullish-derivatives-public-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

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

OpenAPI Specification

bullish-derivatives-public-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: REST API specification for the Bullish Trading API.
  version: 1.0.0
  title: Bullish Trading Derivatives Public API
  contact:
    name: Bullish Help Center
    email: support@bullish.com
    url: https://support.bullish.com
servers:
- url: https://api.exchange.bullish.com/trading-api
  description: PRODUCTION
- url: https://registered.api.exchange.bullish.com/trading-api
  description: PRODUCTION
- url: https://prod.access.bullish.com/trading-api
  description: PRODUCTION (Direct Connect)
- url: https://api.bugbounty.bullish.com/trading-api
  description: SECURITY SANDBOX
- url: https://api.simnext.bullish-test.com/trading-api
  description: API SANDBOX
- url: https://registered.api.simnext.bullish-test.com/trading-api
  description: API SANDBOX
- url: https://simnext.access.bullish.com/trading-api
  description: API SANDBOX (Direct Connect)
tags:
- name: derivatives-public
  x-displayName: Derivatives
paths:
  /v1/option-ladder:
    get:
      parameters:
      - in: query
        name: baseSymbol
        schema:
          $ref: '#/components/schemas/AssetSymbol'
        required: true
        description: symbol to get
      - in: query
        name: expiry
        description: Optional - Filter results by expiry date in YYYYMMDD format (e.g. 20250520)
        schema:
          $ref: '#/components/schemas/OptionExpiryDate'
      - in: query
        name: type
        description: Optional - Filter results by type (`CALL` or ` PUT`) of the option markets
        schema:
          $ref: '#/components/schemas/OptionType'
      - in: query
        name: sort
        description: Optional - Sort results by Option Type or Expiry Datetime
        schema:
          $ref: '#/components/schemas/OptionTypeOrExpiryDatetimeSortAsString'
      tags:
      - derivatives-public
      summary: Get Option Ladder by Base Symbol
      description: 'Returns the available options contracts. This data helps traders quickly assess the available options and their respective prices, implied volatilities, and Greeks (such as delta, gamma, theta, and vega).

        '
      operationId: getOptionLadder
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OptionLadderResponse'
        '400':
          description: Bad Request
        '429':
          description: Too Many Requests
        '500':
          description: Internal Server Error
      security: []
  /v1/option-ladder/{symbol}:
    get:
      parameters:
      - in: path
        name: symbol
        schema:
          $ref: '#/components/schemas/OptionMarketSymbol'
        required: true
        description: symbol to get. Only option markets are supported.
      tags:
      - derivatives-public
      summary: Get Option Ladder by Symbol
      description: 'Returns the for a given `baseSymbol`, organized by strike prices and expiration dates. This data helps traders quickly assess the available options and their respective prices, implied volatilities, and Greeks (such as delta, gamma, theta, and vega).

        '
      operationId: getOptionLadderBySymbol
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptionLadderResponse'
        '400':
          description: Bad Request
        '404':
          description: Option Market Not Found
        '429':
          description: Too Many Requests
        '500':
          description: Internal Server Error
      security: []
  /v1/expiry-prices/{symbol}:
    get:
      summary: Get Expiry Prices
      operationId: get-expiry-prices--symbol
      description: Retrieves Expiry Price and Expiry Notional for respective Options and Dated Futures markets.
      tags:
      - derivatives-public
      parameters:
      - in: path
        name: symbol
        schema:
          $ref: '#/components/schemas/DerivativeMarketSymbol'
        required: true
      responses:
        '200':
          description: Retrieve expiry price and expiry notional for options and dated future.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketExpiryPriceResponse'
        '400':
          description: Expiry price for market is not (yet) available
        '500':
          description: Internal Server Error
        '404':
          description: Invalid symbol provided
components:
  schemas:
    MarketExpiryPriceResponse:
      type: object
      required:
      - symbol
      - expiryPrice
      - expiryNotional
      - expiryDatetime
      - expiryTimestamp
      properties:
        symbol:
          type: string
          description: Market Symbol
          example: BTC-USDC-20250912-95000-C
        expiryPrice:
          type: string
          description: Price used upon Expiry for an Options/Dated Futures contract
          example: '115123.2512'
        expiryNotional:
          type: string
          description: Difference between strike price and expiry price for an Options contract expressed in notional per unit contract
          example: '20123.3033'
        expiryDatetime:
          type: string
          description: Datetime by which the market expires at
          example: '2018-11-18T00:00:00.000Z'
        expiryTimestamp:
          type: string
          description: Timestamp by which the market expires at
          example: '1672041600000'
    QuoteAssetSymbol:
      type: string
      description: asset symbol as denoted in the world
      example: USDC
    DateTime:
      type: string
      format: date-time
      example: '2025-05-20T01:01:01.000Z'
      description: ISO 8601 with millisecond as string
    DerivativeMarketSymbol:
      type: string
      description: market symbol. E.g. `BTC-USDC-20250919-90000-C` for OPTION markets and `BTC-USDC-20250919` for DATED FUTURE markets.
      example: BTC-USDC-20250919-90000-C
    OptionTypeOrExpiryDatetimeSortAsString:
      type: string
      description: Sorting parameter that can have the following string values `"optionType"`, `"expiryDatetime"`
      enum:
      - optionType
      - expiryDatetime
      example: optionType
    OptionType:
      description: Type of Option market
      example: CALL
      type: string
      enum:
      - CALL
      - PUT
    OptionLadderResponse:
      description: Option Ladder Response
      type: object
      properties:
        symbol:
          description: Symbol of the option market. For example `BTC-USDC-20241004-70000-C`
          allOf:
          - $ref: '#/components/schemas/OptionMarketSymbol'
        baseSymbol:
          description: Base symbol of the option market. For `BTC-USDC-20241004-70000-C`, it will be `BTC`
          allOf:
          - $ref: '#/components/schemas/AssetSymbol'
        settlementAssetSymbol:
          description: Asset used for Mark To Market settlement
          allOf:
          - $ref: '#/components/schemas/QuoteAssetSymbol'
        bidQuantity:
          description: Quantity of `bid`
          type: string
          example: '0.0'
        askQuantity:
          description: Quantity of `ask`
          type: string
          example: '0.0'
        bidIVPercentage:
          description: Implied volatility of the best bid price
          type: string
          example: '99.0'
        askIVPercentage:
          description: Implied volatility of the best ask price
          type: string
          example: '99.0'
        bid:
          description: Bid price in the order book
          type: string
          example: '90000.0000'
        ask:
          description: Ask price in the order book
          type: string
          example: '90000.0000'
        underlyingPrice:
          description: Index price of the base asset
          type: string
          example: '100000.0000'
        optionStrikePrice:
          description: Strike price of the option market
          type: string
          example: '90000'
        markPrice:
          description: Mark Price of the option market
          type: string
          example: '100.0000'
        quantity:
          description: Number of contracts outstanding
          type: string
          example: '1000'
        openInterest:
          description: Amount of outstanding contracts in the exchange
          type: string
          example: '0.11442400'
        openInterestUSD:
          description: USD value of outstanding contracts in the exchange
          type: string
          example: '1144240.0000'
        optionType:
          description: Specifies if it's a call (right to buy) or a put (right to sell)
          allOf:
          - $ref: '#/components/schemas/OptionType'
        expiryDatetime:
          allOf:
          - $ref: '#/components/schemas/DateTime'
        greeks:
          description: Option greeks
          allOf:
          - $ref: '#/components/schemas/OptionGreeks'
    OptionGreeks:
      description: Pricing parameters for option instruments. Only returned for option markets and omitted for spot and perpetual markets.
      type: object
      properties:
        delta:
          description: Sensitivity of an option's price to a $1 change in the price of the underlying asset. Only present for option markets.
          type: string
          example: '0.98'
        gamma:
          description: Rate of change of Delta with respect to a $1 change in the underlying asset's price. Only present for option markets.
          type: string
          example: '0.98'
        theta:
          description: The rate at which an option's price decreases as it approaches its expiration date. Only present for option markets.
          type: string
          example: '-0.17'
        vega:
          description: Sensitivity of an option's price to a 1% change in the implied volatility of the underlying asset. Only present for option markets.
          type: string
          example: '0.05'
    OptionExpiryDate:
      type: string
      example: '20250520'
      description: Expiry date of the option market in YYYYMMDD format (e.g. 20250520)
    AssetSymbol:
      type: string
      description: asset symbol as denoted in the world
      example: BTC
    OptionMarketSymbol:
      type: string
      description: market symbol. E.g. `BTC-USDC-20241004-70000-C` for OPTION markets.
      example: BTC-USDC-20241004-70000-C
  securitySchemes:
    jwtTokenAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-tagGroups:
- name: Public Endpoints
  tags:
  - general
  - asset-data
  - market-data
  - market-history-data
  - index-price-data
  - derivatives-public
  - auction-public
- name: Private Endpoints
  tags:
  - session-management
  - trading-accounts
  - account-assets
  - orders
  - trades
  - amm-instructions
  - transfer
  - custody
  - derivatives
  - market-maker-protection
  - history
  - otc
  - idb
  - portfolio-margin-simulator