> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt
> Use this file to discover all available pages before exploring further.
# US Market API
> US equities, ETFs, ADRs, and market indices — reference data, quotes, and historical charts.
Alongside NGX data, the NGN Market API gives you programmatic access to about 12,000 US tickers across common stock, ETFs, ADRs, preferred shares, units, warrants, and other supported security types, plus major US indices. Same base URL, same API key, and one shared monthly quota — US and NGX calls draw from the same pool, this is one product, not a separate account or a separate price.
Profiles, current quotes, and historical price charts
S\&P 500, Dow Jones, Nasdaq Composite, and more
Status, movers, breadth, sectors, and historical trending
## Base URL
```
https://api.ngnmarket.com/v1/us
```
Authentication and rate limits are identical to the rest of the API — see the [main API Reference](/api-reference/introduction) if you haven't set up a key yet. ETFs aren't a separate endpoint family here — filter `/us/tickers?type=etf` and use the same detail/chart routes as any other ticker.
**US coverage is not yet at parity with NGX.** There are no financial statements, no options data, and no SEC Form 4 insider-transaction feed for US tickers today — `/us/tickers/:symbol/officers` returns the corporate leadership roster (name, title, term), not trade-level insider activity. Daily price history starts 2021-08-03 and is **unadjusted** for splits/dividends. This page will be updated as coverage grows.
## Data freshness and coverage
US quotes are delayed. Around 500 widely followed stocks and ADRs refresh approximately every 20 minutes during regular US trading hours, with a source delay of at least 15 minutes. Other actively followed securities may refresh more frequently based on demand. The broader market universe updates on a rotating nightly schedule over multiple processing cycles, so freshness varies by security.
Use each row's `quote_time` to determine exactly when its quote was captured. The response-level `meta.as_of` and `meta.newest` fields summarize the range of quote timestamps in that response.
This data is designed for research, screening, portfolio monitoring, comparison, and historical reference. It is not a real-time execution feed.
We plan to expand US coverage, refresh capacity, and available datasets over time. If you need custom usage limits, dedicated support, or US data that is not currently exposed by the API, [contact us about Enterprise access](https://ngnmarket.com/contact?topic=api_access) or email [support@ngnmarket.com](mailto:support@ngnmarket.com).
## Response envelope
US responses use the same `{ success, data }` shape as the rest of the API. Their `meta` object also identifies the market and currency and reports response freshness:
```json theme={null}
{
"success": true,
"data": { /* ... */ },
"meta": {
"market": "US",
"currency": "USD",
"as_of": "2026-09-18T20:15:00.000Z",
"newest": "2026-09-18T20:15:00.000Z"
}
}
```
`as_of`/`newest` are the oldest/newest quote timestamps found anywhere in that response's data, or the response's aggregate `oldest`/`newest` values when it has no quote rows. For quote-bearing rows, `quote_time` is the authoritative timestamp for that row; use it directly rather than inferring freshness from the envelope alone. Responses without quote timestamps return `null` for these freshness fields.
## Ticker symbol case
**US ticker symbols are case-sensitive** — `TpC` and `TPC` can be different tickers, so pass the exact case returned by `/us/tickers` or `/us/tickers/identifiers`. This differs from NGX, where company symbols are case-insensitive. Index symbols (e.g. `$SPX`) remain case-insensitive.
## Plans and pricing
US endpoints aren't a separate product — they're gated by the same six plans as NGX, drawing from the same monthly call pool. See **[US Market Plans and Pricing](/us/plans)** for pricing, the full US endpoint-by-plan table, and history depth rules.