Playground

API Playground

Test Rulebook Company API endpoints directly from your browser.

Note: The playground uses sample data for demonstration. You’ll need a valid API key for production access.

Sample API Calls

List Exchanges

Discover which exchanges your API key has access to:

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

import requests

url = "https://api.rulebookcompany.com/api/v1/exchanges/"
headers = {
    "x-rulebook-api-access-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

const url = "https://api.rulebookcompany.com/api/v1/exchanges/";
const headers = {
  "x-rulebook-api-access-key": "YOUR_API_KEY",
};

fetch(url, { headers })
  .then((response) => response.json())
  .then((data) => console.log(data));

Example Response:

{
  "data": [
    {
      "name": "nasdaq",
      "display_name": "Nasdaq Stock Exchange",
      "fee_types": ["option"],
      "record_count": 169
    },
    {
      "name": "nasdaq_phlx",
      "display_name": "Nasdaq Stock Exchange PHLX",
      "fee_types": ["option"],
      "record_count": 2383
    }
  ],
  "meta": {
    "record_count": 6,
    "query_time_ms": 67
  }
}

Get Available Filters

Discover valid filter values before querying fee schedules:

curl -X GET "https://api.rulebookcompany.com/api/v1/fee-schedule-results/filters" \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

import requests

url = "https://api.rulebookcompany.com/api/v1/fee-schedule-results/filters"
headers = {
    "x-rulebook-api-access-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

const url =
  "https://api.rulebookcompany.com/api/v1/fee-schedule-results/filters";
const headers = {
  "x-rulebook-api-access-key": "YOUR_API_KEY",
};

fetch(url, { headers })
  .then((response) => response.json())
  .then((data) => console.log(data));

Example Response:

{
  "data": {
    "exchange_names": ["nasdaq", "nasdaq_gemx", "nasdaq_ise", "nasdaq_mrx", "nasdaq_phlx", "nasdaq_texas"],
    "fee_types": ["option"],
    "fee_categories": [
      "fees_and_rebates",
      "legal_regulatory_fee",
      "market_data_fees",
      "participant_fee",
      "port_fees_and_other_services"
    ],
    "fee_actions": ["make", "open", "other", "routed", "take"],
    "fee_participants": [
      "all",
      "away_market_maker",
      "broker_dealer",
      "customer",
      "firm",
      "market_maker",
      "other",
      "professional"
    ],
    "fee_symbol_classifications": ["all", "equity_class", "etf", "index", "not_applicable"],
    "fee_symbol_types": ["both", "non_penny", "not_applicable", "penny"],
    "fee_trade_types": []
  },
  "meta": {
    "record_count": 6773,
    "query_time_ms": 127
  }
}

List Fee Schedule Results

Query fee schedule data with filters, sorting, and pagination:

curl -X GET "https://api.rulebookcompany.com/api/v1/fee-schedule-results/?exchange_name=nasdaq&fee_type=option&fee_action=make&latest_only=true&page_size=5" \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

import requests

url = "https://api.rulebookcompany.com/api/v1/fee-schedule-results/"
params = {
    "exchange_name": "nasdaq",
    "fee_type": "option",
    "fee_action": "make",
    "latest_only": True,
    "page_size": 5
}
headers = {
    "x-rulebook-api-access-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

const params = new URLSearchParams({
  exchange_name: "nasdaq",
  fee_type: "option",
  fee_action: "make",
  latest_only: "true",
  page_size: "5",
});

const url = `https://api.rulebookcompany.com/api/v1/fee-schedule-results/?${params}`;
const headers = {
  "x-rulebook-api-access-key": "YOUR_API_KEY",
};

fetch(url, { headers })
  .then((response) => response.json())
  .then((data) => console.log(data));

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",
      "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": 34,
    "current_page": 0,
    "page_size": 5,
    "query_time_ms": 294
  }
}

Interactive Testing

Download Sample Data

Get sample datasets to test your integration locally before using the live API.

Common Testing Scenarios

Fee Optimization

Compare fee schedules across exchanges to find the most cost-effective venues for your trading strategy.

Historical Analysis

Query historical data to backtest how fee changes would have impacted past trades.

Rule Changes

Monitor when exchange rules change and test how your systems respond to updates.

Multi-Venue Routing

Test smart order routing logic across multiple venues with real microstructure data.

Get Started

API Playground

Sample API Calls

List Exchanges

Get Available Filters

List Fee Schedule Results

Interactive Testing

Download Sample Data

Common Testing Scenarios

Fee Optimization

Historical Analysis

Rule Changes

Multi-Venue Routing

Next Steps

API Reference

Authentication

​API Playground

​Sample API Calls

​List Exchanges

​Get Available Filters

​List Fee Schedule Results

​Interactive Testing

Download Sample Data

​Common Testing Scenarios

Fee Optimization

Historical Analysis

Rule Changes

Multi-Venue Routing

​Next Steps

API Reference

Authentication

API Playground

Sample API Calls

List Exchanges

Get Available Filters

List Fee Schedule Results

Interactive Testing

Common Testing Scenarios

Next Steps