Get Fee Schedule Result - Rulebook Company

Overview

Returns a single fee schedule result by its unique ID. Access is scoped — you can only retrieve results for 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.

Path Parameters

record_id

string (uuid)

required

Unique identifier of the fee schedule result. Obtain IDs from the List Fee Schedule Results endpoint.

Query Parameters

include_footnotes

boolean

default:"false"

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

include_definitions

boolean

default:"false"

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

include_source

boolean

default:"false"

When true, includes source_document, source_link, and page_number fields in the result.

Request

curl -X GET "https://api.rulebookcompany.com/api/v1/fee-schedule-results/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

With Source and Relationships

curl -X GET "https://api.rulebookcompany.com/api/v1/fee-schedule-results/ae619174-ca79-432a-b437-b653cb6e145b?include_source=true&include_footnotes=true&include_definitions=true" \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

Response

data

object

Fee schedule result object (same schema as items in the list endpoint)

Show Fee Schedule Result

record_id

string (uuid)

Unique identifier

exchange_name

string

Exchange identifier (matches the name field from List Exchanges)

scraped_time

string (date-time)

When the fee schedule was scraped

version_id

string (uuid)

Fee extraction version identifier

fee_type

string

Fee type: option or equity

source_document

string | null

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

source_link

string | null

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

page_number

integer | null

Page number in the source document. Only present when include_source=true.

fee_category

string

Fee category

fee_charge_type

string

Whether this is a charge or rebate

fee_amount

string

Fee or rebate amount

fee_action

string

Trading action type

fee_action_details

string | null

Additional action details

fee_basis

string | null

Basis for fee calculation

fee_participant

string

Market participant type

fee_participant_details

string | null

Participant classification details

fee_monthly_volume

string | null

Volume threshold for tiered pricing

fee_monthly_volume_criteria

string | null

Volume tier criteria

fee_symbol_classification

string | null

Symbol classification

fee_symbol_type

string | null

Penny/Non-Penny classification

fee_trade_type

string | null

Trade type

fee_symbol

string | null

Specific symbol(s)

fee_excluded_symbols

string | null

Excluded symbols

fee_conditions

string | null

Conditions for this fee

fee_exclusions

string | null

Scenarios where this fee does not apply

fee_notes

string | null

Additional notes

fee_extra_info

string | null

Additional information

relationships

object | null

Related footnotes and definitions. Only included when include_footnotes or include_definitions are true.

Show Relationships

footnotes

array

Array of footnote objects, each with a text field

definitions

array

Array of definition objects, each with term and text fields

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": 1,
    "query_time_ms": 212
  }
}

Error Responses

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key."
  },
  "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.

Path Parameters

record_id

string<uuid>

required

Unique identifier of the fee schedule result

Query Parameters

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

Fee schedule result

data

object

A single fee/rebate line item extracted from an exchange fee schedule document

Show child attributes

​Overview

​Path Parameters

​Query Parameters

​Request

​With Source and Relationships

​Response

​Example Response

​Error Responses

Authorizations

Path Parameters

Query Parameters

Response

Overview

Path Parameters

Query Parameters

Request

With Source and Relationships

Response

Example Response

Error Responses