Get Fee Schedule Result - Rulebook Company

Get fee schedule result

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

import requests

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

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/{record_id}', 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/{record_id}",
  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/{record_id}"

	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/{record_id}")

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": "FORBIDDEN",
    "message": "You do not have access to this exchange's data."
  },
  "meta": { "query_time_ms": 1 }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Fee schedule result not found."
  },
  "meta": { "query_time_ms": 1 }
}

GET

fee-schedule-results

{record_id}

Get fee schedule result

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

import requests

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

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/{record_id}', 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/{record_id}",
  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/{record_id}"

	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/{record_id}")

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": "FORBIDDEN",
    "message": "You do not have access to this exchange's data."
  },
  "meta": { "query_time_ms": 1 }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Fee schedule result not found."
  },
  "meta": { "query_time_ms": 1 }
}

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

string (uuid)

required

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

Query Parameters

boolean

default:"false"

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

boolean

default:"false"

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

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

object

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

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

string (uuid)

Fee extraction version identifier

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. Only present when include_source=true.

string

Fee category

string

Whether this is a charge or rebate

string

Fee or rebate amount

string

Trading action type

string | null

Additional action details

string | null

Basis for fee calculation

string

Market participant type

string | null

Participant classification details

string | null

Volume threshold for tiered pricing

string | null

Volume tier criteria

string | null

Symbol classification

string | null

Penny/Non-Penny classification

string | null

Trade type

string | null

Specific symbol(s)

string | null

Excluded symbols

string | null

Conditions for this fee

string | null

Scenarios where this fee does not apply

string | null

Additional notes

string | null

Additional information

object | null

Related footnotes and definitions. Only included when include_footnotes or include_definitions are 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

Response metadata

Show Meta

integer

Always 1 for single-record responses

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

Error Responses

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

{
  "error": {
    "code": "FORBIDDEN",
    "message": "You do not have access to this exchange's data."
  },
  "meta": { "query_time_ms": 1 }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Fee schedule result not found."
  },
  "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