GET
/
api
/
v1
/
suppliers
/
{supplier_name}
/
fee-categories
Get Available Fee Categories
curl --request GET \
  --url https://api.example.com/api/v1/suppliers/{supplier_name}/fee-categories
{
  "error": "Bad Request",
  "message": "Invalid date format",
  "details": {
    "field": "start_date",
    "expected_format": "YYYY-MM-DD"
  }
}

​
Overview

This endpoint returns all available fee categories for a specific exchange/supplier. Use this to discover which fee categories have data available before making detailed data requests.
Authorization Required - You must include a valid Bearer token in the Authorization header. Contact sales@rulebook.company to obtain API access.

​
Path Parameters

​
supplier_name
string
required
The name or code of the supplier (e.g., NYSE, NASDAQ, CBOE)

​
Query Parameters

​
start_date
string
Optional: Filter by start date (ISO 8601 format: YYYY-MM-DD)
​
end_date
string
Optional: Filter by end date (ISO 8601 format: YYYY-MM-DD)

​
Request

curl -X GET https://api.rulebook.company/v1/suppliers/NYSE/fee-categories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
With Date Range Filter

curl -X GET "https://api.rulebook.company/v1/suppliers/NYSE/fee-categories?start_date=2024-01-01&end_date=2024-12-31" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response

​
supplier
string
Name of the supplier
​
date_range
object
Date range filter applied (if any)
​
fee_categories
array
Array of available fee category objects

​
Example Response

{
  "success": true,
  "data": {
    "supplier": "NYSE",
    "date_range": null,
    "fee_categories": [
      {
        "category": "Fee And Rebates",
        "display_name": "Fee And Rebates",
        "description": "Standard trading fees and liquidity rebates",
        "available": true,
        "record_count": 12500,
        "applicable_fee_types": ["equity", "option"]
      },
      {
        "category": "Legal Regulatory Fees",
        "display_name": "Legal & Regulatory Fees",
        "description": "SEC fees, FINRA fees, and other regulatory charges",
        "available": true,
        "record_count": 3200,
        "applicable_fee_types": ["equity", "option"]
      },
      {
        "category": "Market Data Fees",
        "display_name": "Market Data Fees",
        "description": "Real-time and delayed market data subscription fees",
        "available": true,
        "record_count": 1850,
        "applicable_fee_types": ["equity", "option"]
      },
      {
        "category": "Participant Fee",
        "display_name": "Participant Fees",
        "description": "Membership and participation fees",
        "available": true,
        "record_count": 960,
        "applicable_fee_types": ["equity", "option"]
      },
      {
        "category": "Port Fees And Other Services",
        "display_name": "Port Fees And Other Services",
        "description": "Connection fees, ports, and additional services",
        "available": true,
        "record_count": 2400,
        "applicable_fee_types": ["equity", "option"]
      }
    ],
    "total_categories": 5
  }
}

​
Fee Category Details

Standard trading fees charged for taking liquidity and rebates paid for providing liquidity to the order book.
Fees for market data access including:
  • Real-time quotes and trades
  • Delayed market data
  • Historical data access
  • Data redistribution fees
Membership and participation related fees:
  • Annual membership fees
  • Trading permit fees
  • Market maker registration fees
Infrastructure and additional service fees:
  • Network connectivity fees
  • Port and connection fees
  • Co-location services
  • Testing environment access

​
Error Responses

{
  "error": "Bad Request",
  "message": "Invalid date format",
  "details": {
    "field": "start_date",
    "expected_format": "YYYY-MM-DD"
  }
}