country
Listing locale from the reference vendor, not the issuer's home country. Every US-listed symbol, including ADRs, reports `us`. For where the company is run from and where it is incorporated, use `issuer_country` and `incorporation_country`.
Swap YOUR_KEY for a key from /dashboard/keys. Responses are real captures from 2026-09-18, trimmed.
The whole market, filtered on it /v2/scan
Live — the whole market, ranked by this column
curl -X POST "https://api.tickerbot.io/v2/scan" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{ "q": "country IS NOT NULL", "order": "country", "columns": "country" }'Response (sampled 2026-09-18, trimmed)
{
"as_of": "2026-09-18T14:37:58.928Z",
"query": {
"q": "country IS NOT NULL",
"limit": 2,
"order": "country",
"dir": "desc",
"fields": [
"country"
],
"full": false,
"universe": null,
"asset_class": null
},
"count": 2,
"results": [
{
"ticker": "A",
"name": "Agilent Technologies Inc.",
"asset_class": "stocks",
"asset_type": "CS",
"price": 156.353,
"change_1d_pct": 0.008315210438790605,
"gap_pct": -0.2175,
"relative_volume": 0.258,
"market_cap": 43329645571,
"country": "us"
},
{
"ticker": "AA",
"name": "Alcoa Corporation",
"asset_class": "stocks",
"asset_type": "CS",
"price": 46.067,
"change_1d_pct": -1.9225037257824116,
"gap_pct": -0.0319,
"relative_volume": 0.2018,
"market_cap": 12208450925,
"country": "us"
}
]
}Same grammar on scan and webhooks. This signal is live-tense only — it isn't historized, so ?asof= reads and series pulls don't carry it.