List Fee Schedule Results - Rulebook Company

List fee schedule results

curl --request GET \
  --url https://api.rulebookcompany.com/api/v1/fee-schedule-results/ \
  --header 'x-rulebook-api-access-key: <api-key>'

import requests

url = "https://api.rulebookcompany.com/api/v1/fee-schedule-results/"

headers = {"x-rulebook-api-access-key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'x-rulebook-api-access-key': '<api-key>'}};

fetch('https://api.rulebookcompany.com/api/v1/fee-schedule-results/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rulebookcompany.com/api/v1/fee-schedule-results/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-rulebook-api-access-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rulebookcompany.com/api/v1/fee-schedule-results/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-rulebook-api-access-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.rulebookcompany.com/api/v1/fee-schedule-results/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-rulebook-api-access-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid query parameters.",
    "details": []
  },
  "meta": { "query_time_ms": 1 }
}

GET

fee-schedule-results

List fee schedule results

curl --request GET \
  --url https://api.rulebookcompany.com/api/v1/fee-schedule-results/ \
  --header 'x-rulebook-api-access-key: <api-key>'

import requests

url = "https://api.rulebookcompany.com/api/v1/fee-schedule-results/"

headers = {"x-rulebook-api-access-key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'x-rulebook-api-access-key': '<api-key>'}};

fetch('https://api.rulebookcompany.com/api/v1/fee-schedule-results/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rulebookcompany.com/api/v1/fee-schedule-results/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-rulebook-api-access-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rulebookcompany.com/api/v1/fee-schedule-results/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-rulebook-api-access-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.rulebookcompany.com/api/v1/fee-schedule-results/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-rulebook-api-access-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid query parameters.",
    "details": []
  },
  "meta": { "query_time_ms": 1 }
}

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.

Use Get Available Filters or Get Exchange Details to discover valid filter values before querying.

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.

string[]

Filter by exchange identifier(s) — use values from the exchange_names field returned by Get Available FiltersExample: ?exchange_name=nasdaq&exchange_name=nasdaq_phlx

string[]

Filter by fee type(s): option, equity

string[]

Filter by fee category(s): fees_and_rebates, general_provisions, legal_regulatory_fee, market_data_fees, participant_fee, port_fees_and_other_services

string[]

Filter by trading action(s): make, take, open, routed, other

string[]

Filter by participant type(s): customer, firm, broker_dealer, market_maker, away_market_maker, professional, other, all

string[]

Filter by symbol classification(s): etf, etn, equity_class, index, not_applicable, all

string[]

Filter by symbol type(s): penny, non_penny, not_applicable, both

string[]

Filter by trade type(s): index_options, multiply_traded_options, simple_order, complex_order

Date Range

string

Filter results scraped on or after this date (format: YYYY-MM-DD)

string

Filter results scraped on or before this date (format: YYYY-MM-DD)

Versioning

boolean

default:"false"

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

string

default:"created_on"

Field to sort by: created_on, scraped_time, fee_type, fee_category

string

default:"desc"

Sort direction: asc or desc

Pagination

integer

default:"20"

Records per page (1–100)

integer

default:"0"

Page number (0-indexed)

Relationships

boolean

default:"false"

When true, includes resolved footnotes from the source document in the relationships field of each result.

boolean

default:"false"

When true, includes resolved definitions from the source document in the relationships field of each result.

Source Document

boolean

default:"false"

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

Array of fee schedule result objects

Show Fee Schedule Result

string (uuid)

Unique identifier

string

Exchange identifier (matches the name field from List Exchanges)

string (date-time)

When the fee schedule was scraped from the exchange

string (uuid)

Fee extraction version identifier. Use with the Get Results by Version endpoint to fetch all fees from this version.

string

Fee type: option or equity

string | null

Title of the source fee schedule document. Only present when include_source=true.

string | null

URL to the source fee schedule document on CDN. Only present when include_source=true.

integer | null

Page number in the source document where this fee was extracted. Only present when include_source=true.

string

Fee category

string

Whether this is a charge or rebate

string

Fee or rebate amount (may include currency, ranges, or tier descriptions)

string

Trading action type: make, take, open, routed, other

string | null

Additional action details

string | null

Basis for fee calculation (per share, per contract, percentage, etc.)

string

Market participant type

string | null

Additional participant classification details

string | null

Monthly volume threshold for tiered pricing

string | null

Criteria used to determine volume tier

string | null

Symbol classification: etf, etn, equity_class, index, not_applicable, all

string | null

Penny or Non-Penny classification

string | null

Trade type

string | null

Specific symbol(s) this fee applies to

string | null

Symbols excluded from this fee

string | null

Conditions that must be met

string | null

Scenarios where this fee does not apply

string | null

Additional notes or context

string | null

Additional information

object | null

Related footnotes and definitions from the source document. Only included when include_footnotes or include_definitions query parameters are set to true.

Show Relationships

array

Array of footnote objects, each with a text field

array

Array of definition objects, each with term and text fields

object

Pagination and performance metadata

Show Meta

integer

Total records matching the filter criteria (across all pages)

integer

Total number of pages

integer

Current page number (0-indexed)

integer

Records per page

integer | null

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
  }
}

Pagination

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

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

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid query parameters.",
    "details": []
  },
  "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.

Query Parameters

exchange_name

string[]

Filter by exchange name(s). Repeat for multiple: ?exchange_name=CBOE&exchange_name=NYSE

fee_type

string[]

Filter by fee type(s): option, equity

fee_category

string[]

Filter by fee category(s): fees_and_rebates, general_provisions, legal_regulatory_fee, market_data_fees, participant_fee, port_fees_and_other_services

fee_action

enum<string>[]

Filter by trading action(s)

Available options:

make,

take,

open,

routed,

other

fee_participant

enum<string>[]

Filter by participant type(s)

Available options:

customer,

firm,

broker_dealer,

market_maker,

away_market_maker,

professional,

other,

all

fee_symbol_classification

enum<string>[]

Filter by symbol classification(s)

Available options:

etf,

etn,

equity_class,

index,

not_applicable,

all

fee_symbol_type

enum<string>[]

Filter by symbol type(s)

Available options:

penny,

non_penny,

not_applicable,

both

fee_trade_type

enum<string>[]

Filter by trade type(s)

Available options:

index_options,

multiply_traded_options,

simple_order,

complex_order

start_date

string<date>

Filter results scraped on or after this date (YYYY-MM-DD)

end_date

string<date>

Filter results scraped on or before this date (YYYY-MM-DD)

latest_only

boolean

default:false

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

Field to sort results by

Available options:

created_on,

scraped_time,

fee_type,

fee_category

order_dir

enum<string>

default:desc

Sort direction

Available options:

asc,

desc

page_size

integer

default:20

Number of records per page (1-100)

Required range: 1 <= x <= 100

page_number

integer

default:0

Page number (0-indexed)

Required range: x >= 0

include_footnotes

boolean

default:false

When true, includes resolved footnotes from the source document in the relationships field of each result

include_definitions

boolean

default:false

When true, includes resolved definitions from the source document in the relationships field of each result

include_source

boolean

default:false

When true, includes source_document, source_link, and page_number fields in each result

Response

Paginated fee schedule results

data

object[]

Show child attributes

​Overview

​Query Parameters

​Filters

​Date Range

​Versioning

​Sorting

​Pagination

​Relationships

​Source Document

​Request Examples

​Response

​Example Response

​Pagination

​Error Responses

Authorizations

Query Parameters

Response

Overview

Query Parameters

Filters

Date Range

Versioning

Sorting

Pagination

Relationships

Source Document

Request Examples

Response

Example Response

Pagination

Error Responses