GET
/
exchanges
List exchanges
curl --request GET \
  --url https://api.rulebook.company/api/v1/exchanges/ \
  --header 'x-rulebook-api-access-key: <api-key>'
{
  "message": "You are not authorized to perform this action. Invalid API key.",
  "data": [],
  "query_time": null,
  "success": false,
  "disable_jsonable_encoder": false,
  "status_code": 401
}

​
Overview

Returns all exchanges available to your account. Each exchange includes a summary of available fee types and the total record count. Use this as your starting point to discover what data you can query.
Authorization Required - Include your API key in the x-rulebook-api-access-key header. Contact sales@rulebook.company to obtain access.

​
Request

curl -X GET https://api.rulebook.company/api/v1/exchanges/ \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

​
Response

​
success
boolean
Whether the request was successful
​
message
string
Human-readable status message
​
data
array
Array of exchange objects

​
Example Response

{
  "message": "Operation completed successfully.",
  "data": [
    {
      "name": "Nasdaq",
      "display_name": "Nasdaq Stock Exchange",
      "fee_types": ["OPTION"],
      "record_count": 915
    },
    {
      "name": "fee_cboe_us_options",
      "display_name": "Fee - CBOE US Options",
      "fee_types": ["OPTION"],
      "record_count": 1787
    }
  ],
  "query_time": null,
  "success": true,
  "disable_jsonable_encoder": false
}

​
Next Steps

After listing exchanges, call Get Exchange Details to see all available filter values for a specific exchange, or go directly to List Fee Schedule Results to start querying data.

​
Error Responses

{
  "message": "You are not authorized to perform this action. Invalid API key.",
  "data": [],
  "query_time": null,
  "success": false,
  "disable_jsonable_encoder": false,
  "status_code": 401
}

Authorizations

​
x-rulebook-api-access-key
string
header
required

API access key provided by Rulebook Company. Contact sales@rulebook.company to obtain one.

Response

List of exchanges

​
success
boolean
Example:

true

​
message
string
Example:

"Operation completed successfully."

​
data
object[]