Overview Returns a paginated list of fee schedule results with comprehensive filtering. Each result represents a single fee or rebate line item extracted from an exchange’s fee schedule document.
Results are automatically scoped to exchanges associated with your API key.
Authorization Required - Include your API key in the
x-rulebook-api-access-key header. Contact
aaron@rulebookcompany.com to obtain
access.Query Parameters Filters All filter parameters accept multiple values using repeated query parameters (e.g., ?exchange_name=nasdaq&exchange_name=nasdaq_phlx). Multiple values are combined with OR logic.
Filter by exchange identifier(s) — use values from the exchange_names field returned by Get Available Filters Example: ?exchange_name=nasdaq&exchange_name=nasdaq_phlxFilter by fee type(s): option, equity
Filter by fee category(s): fees_and_rebates, general_provisions, legal_regulatory_fee,
market_data_fees, participant_fee, port_fees_and_other_services
Filter by trading action(s): make, take, open, routed, other
Filter by participant type(s): customer, firm, broker_dealer, market_maker,
away_market_maker, professional, other, all
fee_symbol_classification
Filter by symbol classification(s): etf, etn, equity_class, index, not_applicable, all
Filter by symbol type(s): penny, non_penny, not_applicable, both
Filter by trade type(s): index_options, multiply_traded_options, simple_order, complex_order
Date Range Filter results scraped on or after this date (format: YYYY-MM-DD)
Filter results scraped on or before this date (format: YYYY-MM-DD)
Versioning When true, returns only the most recent version per unique (supplier,
fee_type) combination. Use this to get only the current fee data without
historical versions.
Sorting order_by
string
default: "created_on"
Field to sort by: created_on, scraped_time, fee_type, fee_category
Sort direction: asc or desc
Relationships When true, includes resolved footnotes from the source document in the relationships field of each result.
When true, includes resolved definitions from the source document in the relationships field of each result.
Source Document When true, includes source_document, source_link, and page_number fields in each result.
Request Examples Basic request — latest Nasdaq options fees: curl -X GET "https://api.rulebookcompany.com/api/v1/fee-schedule-results?exchange_name=nasdaq&fee_type=option&latest_only=true" \ -H "x-rulebook-api-access-key: YOUR_API_KEY"
Multi-exchange Market Maker Make fees: curl -X GET "https://api.rulebookcompany.com/api/v1/fee-schedule-results?exchange_name=nasdaq&exchange_name=nasdaq_phlx&fee_action=make&fee_participant=market_maker&latest_only=true&page_size=50" \ -H "x-rulebook-api-access-key: YOUR_API_KEY"
Penny ETF fees scraped in 2025, with source document: curl -X GET "https://api.rulebookcompany.com/api/v1/fee-schedule-results/?fee_symbol_classification=etf&fee_symbol_type=penny&start_date=2025-01-01&end_date=2025-12-31&include_source=true" \ -H "x-rulebook-api-access-key: YOUR_API_KEY"
Response Array of fee schedule result objects When the fee schedule was scraped from the exchange
Fee extraction version identifier. Use with the Get Results by Version endpoint to fetch all fees from this version. Fee type: option or equity
Title of the source fee schedule document. Only present when include_source=true.
URL to the source fee schedule document on CDN. Only present when include_source=true.
Page number in the source document where this fee was extracted. Only present when include_source=true.
Whether this is a charge or rebate
Fee or rebate amount (may include currency, ranges, or tier descriptions)
Trading action type: make, take, open, routed, other
Additional action details
Basis for fee calculation (per share, per contract, percentage, etc.)
Additional participant classification details
Monthly volume threshold for tiered pricing
fee_monthly_volume_criteria
Criteria used to determine volume tier
fee_symbol_classification
Symbol classification: etf, etn, equity_class, index, not_applicable, all
Penny or Non-Penny classification
Specific symbol(s) this fee applies to
Symbols excluded from this fee
Conditions that must be met
Scenarios where this fee does not apply
Additional notes or context
Related footnotes and definitions from the source document. Only included when include_footnotes or include_definitions query parameters are set to true. Array of footnote objects, each with a text field
Array of definition objects, each with term and text fields
Pagination and performance metadata Total records matching the filter criteria (across all pages)
Current page number (0-indexed)
Query execution time in milliseconds
Example Response { "data" : [ { "record_id" : "a3d76e96-0cad-4ece-9db1-7ad3c743bdf8" , "exchange_name" : "nasdaq" , "scraped_time" : "2026-02-03T05:00:47.409373Z" , "version_id" : "b962c0b1-5d99-4ef6-b3f6-36cb18c08933" , "fee_type" : "option" , "source_document" : "Options 7: Pricing Schedule.html" , "source_link" : "https://d305kadk6uf47m.cloudfront.net/nasdaq/parsed/2026-02-03/4e20f2da680b466a892182fc05efca7124bbaa4e4b5e55d101ed691203824431.pdf" , "page_number" : 8 , "fee_category" : "fees_and_rebates" , "fee_charge_type" : "MARS Payment (Non-Penny)" , "fee_amount" : "$0.81" , "fee_action" : "make" , "fee_action_details" : "Add liquidity" , "fee_basis" : null , "fee_participant" : "all" , "fee_participant_details" : null , "fee_monthly_volume" : "Tier 8" , "fee_monthly_volume_criteria" : "125,000 ADV" , "fee_symbol_classification" : "all" , "fee_symbol_type" : "non_penny" , "fee_trade_type" : null , "fee_symbol" : "{All}" , "fee_excluded_symbols" : "{}" , "fee_conditions" : "Executed Eligible Contracts that add liquidity, routed to NOM through a participating NOM Participant's System and meet the requisite Eligible Contracts ADV" , "fee_exclusions" : "No payment for orders routed to NOM but not executed" , "fee_notes" : null , "fee_extra_info" : null , "relationships" : { "footnotes" : [], "definitions" : [] } } ], "meta" : { "record_count" : 169 , "total_pages" : 169 , "current_page" : 0 , "page_size" : 1 , "query_time_ms" : 294 } }
Make your first request
The response meta includes record_count and total_pages so you know the full dataset size.
Iterate through pages
Increment page_number from 0 to total_pages - 1:
Page 1: ?page_number=0&page_size=50
Page 2: ?page_number=1&page_size=50
Page 3: ?page_number=2&page_size=50
Error Responses 401 Unauthorized
422 Validation Error
{ "error" : { "code" : "UNAUTHORIZED" , "message" : "Missing or invalid API key." }, "meta" : { "query_time_ms" : 1 } }
x-rulebook-api-access-key
Filter by exchange name(s). Repeat for multiple: ?exchange_name=CBOE&exchange_name=NYSE
Filter by fee type(s): option, equity
Filter by fee category(s): fees_and_rebates, general_provisions, legal_regulatory_fee, market_data_fees, participant_fee, port_fees_and_other_services
Filter by trading action(s)
Available options:
make,
take,
open,
routed,
other
Filter by participant type(s)
Available options:
customer,
firm,
broker_dealer,
market_maker,
away_market_maker,
professional,
other,
all
fee_symbol_classification
Filter by symbol classification(s)
Available options:
etf,
etn,
equity_class,
index,
not_applicable,
all
Available options:
penny,
non_penny,
not_applicable,
both
Available options:
index_options,
multiply_traded_options,
simple_order,
complex_order
Filter results scraped on or after this date (YYYY-MM-DD)
Filter results scraped on or before this date (YYYY-MM-DD)
When true, returns only the latest version per unique (supplier, fee_type) combination. Useful for getting only current fee data.
order_by
enum<string>
default: created_on
Available options:
created_on,
scraped_time,
fee_type,
fee_category
Available options:
asc,
desc
Number of records per page (1-100)
Required range: 1 <= x <= 100
When true, includes resolved footnotes from the source document in the relationships
When true, includes resolved definitions from the source document in the relationships
When true, includes source_document source_link page_number
Paginated fee schedule results
Pagination and performance metadata
