​
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"
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"
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"
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.

​
Next Steps

API Reference

Explore all available endpoints and parameters.

Authentication

Learn about API authentication and security.