GET
/
exchanges
/
{exchange_name}
Get exchange details
curl --request GET \
  --url https://api.rulebookcompany.com/api/v1/exchanges/{exchange_name} \
  --header 'x-rulebook-api-access-key: <api-key>'
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key."
  },
  "meta": { "query_time_ms": 1 }
}

​
Overview

Returns full metadata for a single exchange, including all available filter values: fee types, fee categories, actions, participants, symbol classifications, symbol types, trade types, and the date range of available data. The values returned in the filter arrays are the exact values to pass as query parameters when calling List Fee Schedule Results.
Authorization Required - Include your API key in the x-rulebook-api-access-key header. Contact aaron@rulebookcompany.com to obtain access.
This endpoint consolidates all discovery information into a single call. Instead of making separate requests for fee types, categories, actions, and participants, get everything at once.

​
Path Parameters

​
exchange_name
string
required
Exchange identifier (e.g., nasdaq, nasdaq_phlx). Get the list of available exchanges from List Exchanges.

​
Request

curl -X GET https://api.rulebookcompany.com/api/v1/exchanges/nasdaq \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

​
Response

​
data
object
Exchange detail object
​
meta
object
Response metadata

​
Example Response

{
  "data": {
    "name": "nasdaq",
    "display_name": "Nasdaq Stock Exchange",
    "date_range": {
      "earliest": "2025-12-19",
      "latest": "2026-02-03"
    },
    "fee_types": ["option"],
    "fee_categories": [
      "fees_and_rebates",
      "legal_regulatory_fee",
      "market_data_fees",
      "participant_fee",
      "port_fees_and_other_services"
    ],
    "actions": ["make", "open", "other", "routed", "take"],
    "participants": [
      "all",
      "away_market_maker",
      "broker_dealer",
      "customer",
      "firm",
      "market_maker",
      "other",
      "professional"
    ],
    "symbol_classifications": ["all"],
    "symbol_types": ["both", "non_penny", "penny"],
    "trade_types": []
  },
  "meta": {
    "record_count": 512,
    "query_time_ms": 102
  }
}

​
Using Exchange Details to Build Queries

Use the returned filter values directly as query parameters: 
# Step 1: Get exchange details to see available filters
curl -X GET https://api.rulebookcompany.com/api/v1/exchanges/nasdaq \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

# Step 2: Use the returned values as filter params
curl -X GET "https://api.rulebookcompany.com/api/v1/fee-schedule-results?exchange_name=nasdaq&fee_type=option&fee_action=make&fee_participant=market_maker&latest_only=true" \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

​
Reference: Filter Value Descriptions

ValueDescription
fees_and_rebatesStandard trading fees and liquidity rebates
general_provisionsGeneral rules and provisions applicable to fees
legal_regulatory_feeSEC fees, FINRA TAF, and other regulatory charges
market_data_feesReal-time and delayed market data subscription fees
participant_feeMembership and participation fees
port_fees_and_other_servicesNetwork connectivity, co-location, and port fees
ValueDescription
makeOrders that add liquidity (typically receive rebates)
takeOrders that remove liquidity (typically charged fees)
openOpening auction transactions
routedOrders routed to other venues
otherMiscellaneous action types
ValueDescription
allAggregated across all participant types
market_makerExchange-designated market makers with quoting obligations
away_market_makerMarket makers registered at other exchanges
broker_dealerRegistered broker-dealer firms
customerRetail and institutional customers
firmProprietary trading firms
professionalProfessional individual traders
otherOther participant categories
ValueDescription
etfExchange Traded Funds
etnExchange Traded Notes
equity_classEquity securities
indexIndex options
allAll classifications
not_applicableNot applicable
ValueDescription
pennyPenny increment symbols
non_pennyNon-penny increment symbols
bothApplies to both
not_applicableNot applicable
ValueDescription
simple_orderSimple (single-leg) orders
complex_orderComplex/multi-leg orders
index_optionsIndex option trades
multiply_traded_optionsMultiply-listed options

​
Error Responses

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key."
  },
  "meta": { "query_time_ms": 1 }
}

Authorizations

​
x-rulebook-api-access-key
string
header
required

API access key provided by Rulebook Company. Contact aaron@rulebookcompany.com to obtain one.

Path Parameters

​
exchange_name
string
required

Exchange identifier (e.g., fee_cboe_us_bzx_options, nasdaqphlx). Use values from the List Exchanges endpoint.

Response

Exchange detail

​
data
object

Full metadata for a single exchange including all discoverable filter values

​
meta
object

Metadata for non-paginated responses