​
Welcome to the Rulebook Company API

The Rulebook Company API provides read-only access to comprehensive exchange fee schedule and rebate data across multiple US trading venues. Query historical and current fee schedules, filter by exchange, fee type, participant, action, and more.
Get API Access — Contact our sales team at aaron@rulebookcompany.com or visit our website to obtain your API access key.

​
Base URL

All API requests should be made to: 
https://api.rulebookcompany.com/api/v1

​
Authentication

All endpoints require an API access key in the x-rulebook-api-access-key header: 
curl https://api.rulebookcompany.com/api/v1/exchanges \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"
Learn more in the Authentication section.

​
API Overview

The API is organized into two resource groups. All endpoints are GET requests that return JSON.

​
Exchanges

Discover what exchanges and filter values are available to your account.

List Exchanges

Get all exchanges available to your account with fee types and record counts

Get Exchange Details

Get full metadata for an exchange: date ranges, fee types, categories, actions, participants, and more

​
Fee Schedule Results

Query, filter, and retrieve extracted fee schedule line items.

List Fee Schedule Results

Paginated list with 8 multi-value filters, sorting, date ranges, and latest-only mode

Get Fee Schedule Result

Retrieve a single fee schedule result by ID

Get Results by Version

Get all fee results from a specific extraction version

Get Available Filters

Discover available filter values scoped to your account

​
Typical Workflow

1

Discover exchanges

Call List Exchanges to see what exchanges you have access to.
2

Explore an exchange

Call Get Exchange Details to see all available filter values (fee types, categories, actions, participants, etc.) and the date range of data.
3

Query fee data

Call List Fee Schedule Results with your chosen filters. Use latest_only=true to get only the most current fee data.
4

Paginate through results

Use page_number and page_size to iterate through large result sets.

​
Data Coverage

  • Fee Types: OPTION, EQUITY
  • Fee Categories: Fees And Rebates, General Provisions, Legal Regulatory Fee, Market Data Fees, Participant Fee, Port Fees And Other Services
  • Actions: Make, Take, Open, Routed, Other
  • Participants: Market Makers, Broker Dealers, Customers, Firms, and more
  • Symbol Classifications: ETF, ETN, Equity, Index, N/A, All
  • Symbol Types: Penny, Non Penny, Both, N/A
  • Trade Types: Simple Order, Complex Order, Index Options, Multiply Traded Options, N/A

​
Rate Limits

Rate limits are applied per API key:
  • Burst: up to 300 requests
  • Sustained: ~60 requests per minute
Every response includes rate limit headers:
HeaderDescription
X-RateLimit-LimitMaximum request capacity
X-RateLimit-RemainingRequests remaining
X-RateLimit-ResetUnix timestamp when capacity is next replenished
Retry-AfterSeconds to wait before retrying (only on 429 responses)
When you exceed the rate limit, the API returns 429 Too Many Requests. Wait for the duration in the Retry-After header before retrying. Both SDKs handle 429 responses automatically with exponential backoff (default: 2 retries).

​
Support