- A table is addressed as
{vendor}/{table}, e.g.NDAQ/RTAT10. Both parts are required, and the slash stays literal in the path. - Rows are arrays, not objects. Nasdaq sends
datatable.dataas a list of arrays whose positions matchdatatable.columns, so a caller reads a cell by column index. Usetables.metadatafirst to get the column order and the names that can filter. - Only some columns can filter a query.
tables.metadatalists them infilters. Operators append to the column name and pass throughfiltersuntouched:{ 'date.gte': '2024-01-01', 'ticker.in[]': 'AAPL,MSFT' }. - Paging is a signed cursor, not a page number. Pass the
next_cursor_idfrom one response ascursor_idon the next. It is null (or absent) on the last page, so check for either; that is the only end signal. An expired cursor answers 400QESx06, so a stored cursor cannot be reused later.
- A 403 may not be an auth failure. Nasdaq answers a bad key with a 400 carrying
quandl_error.codeQEAx01, while its Incapsula gateway answers 403 with an HTML page and no JSON on the/datasets/time-series routes for non-browser clients. This plugin wraps the/datatables/routes, which work. The old/databasescatalogue route answers 410 Gone, so it is not wrapped. A 403 is reported as a gateway block rather than a bad key, because telling a caller to re-enter a working key is the wrong fix. - A bulk export is a two-step: the first call usually answers
status: 'creating'with a null link, and a later poll answers'fresh'with a signed URL valid for 30 minutes. The values arrive lowercase although Nasdaq’s docs capitalise them. Nasdaq caps this endpoint at 60 calls an hour. - The Tables API caps a page at 10,000 rows whatever
per_pagesays. A larger table needs the cursor or the export endpoint. - Rate limits differ by plan: 50 calls a day on the free tier, 300 per 10 seconds and 50,000 a day for a key without premium subscriptions.
QEAx06is the daily cap, which no retry clears, andQEAx07asks for a 30-second wait, which the plugin retries twice.
- 3 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Nasdaq Data Link API key before the first call: More: API Key
pnpm corsair setup --plugin=nasdaq --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
Read two rows from a tableWhat’s next
API reference
Every
nasdaq.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.