incorporation_ country
Where the issuer is legally incorporated, as a lower-case ISO 3166-1 alpha-2 code. It comes from the state or country of incorporation in its SEC filings, with US states mapped to us: ky for Huize (Cayman-incorporated, run from China), us for Apple. Null when the symbol has no SEC filer identifier. Pair with issuer_country to tell an offshore-incorporated operator from a domestic one.
Facts
A string signal: screen on it with = or IN (incorporation_country = 'ky'). It's null on tickers it doesn't apply to.
| type | string |
| refresh | weekdays · 2 AM ET |
| asset classes | US equities |
| coverage | all tickers |
| history | live value only |
| nullable | yes |
Examples
Screen on it
curl -X POST "https://api.tickerbot.io/v2/scan" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "incorporation_country = '"'"'ky'"'"'"
}'Get an alert when a ticker starts matching
curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "incorporation_country = '"'"'ky'"'"'",
"target_url": "https://example.com/hooks/tickerbot"
}'Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.