Massive takes whole tapes rather than picking venues, so for US stocks and options the answer to "is venue X included" is yes, including the off-exchange reporting facilities where dark pool prints appear. Crypto and forex work differently, because neither market has a tape to take. Whatever the asset class, the exchanges endpoint is the current list and the authority on what each integer id means.
Applies to
- Plans: reference data is on every plan; the market data itself follows your subscription.
- Endpoints: /v3/reference/exchanges for the list, filtered with asset_class.
- Asset classes: stocks, options, crypto and forex.
What each asset class covers
What each asset class covers is counted from the exchanges endpoint, which is the same list the exchange field indexes into:
| Asset class | Venues |
|---|---|
| Stocks | 27 records: 18 exchanges, 6 trade reporting facilities, 2 SIPs and 1 over-the-counter reporting facility |
| Options | 21 records: 20 exchanges, including the Cboe family, Nasdaq's options markets, NYSE American and BOX, plus OPRA itself |
| Crypto | 5 exchanges: Binance, Bitfinex, Bitstamp, Coinbase and Kraken |
| Forex | Institutional bank feeds rather than exchanges |
| Indices | Not exchanges at all: Nasdaq, Cboe and CME Group as index providers |
The stocks count is worth reading carefully. Only 18 of those 27 are exchanges; the rest are the facilities through which off-exchange trades are reported, which is why an exchange id of 4 is a FINRA facility rather than a venue.
How to map an id to a name
curl -X GET "https://api.massive.com/v3/reference/exchanges?asset_class=stocks&apiKey=YOUR_API_KEY"
Response
{
"results": [
{ "id": 1, "type": "exchange", "mic": "XASE", "name": "NYSE American, LLC" },
{ "id": 3, "type": "exchange", "mic": "XCIS", "name": "NYSE National, Inc." },
{ "id": 4, "type": "TRF", "mic": "XADF", "name": "FINRA Alternative Display Facility" }
],
"status": "OK"
}
Fetch this once and cache it. The ids are stable, and joining against it turns the integers in your trade records into something a human can read.
Why the reporting facilities matter
The reporting facilities matter because a large share of volume never touches an exchange. A trade arranged off-exchange is reported to a FINRA facility and reaches the tape with that facility's id rather than a venue's, which is why filtering to type: exchange would silently drop most of the off-exchange market. If you are measuring where volume happens, read the type field and decide deliberately which records belong in your denominator.
If you see an error
An exchange id you cannot find is usually because you fetched the list for the wrong asset class. Options and stocks have separate id spaces.
A ticker that returns no data on any venue is more likely a symbol convention than a coverage gap. Class shares use a dot and preferred shares a lowercase p.
A crypto pair that exists on an exchange we do not list will have no data. The five above are the sources.
