tickerbot.io

issuer_country

Where the company is run from: the ISO 3166-1 alpha-2 country code (lower-case) of the issuer's business address in its SEC filings. cn for Huize (HUIZ), us for Apple. Null when the symbol has no SEC filer identifier (most ETFs and non-SEC filers). Distinct from country, which is the listing locale, and from incorporation_country, the legal domicile.

Facts

A string signal: screen on it with = or IN (issuer_country = 'cn'). It's null on tickers it doesn't apply to.

typestring
refreshweekdays · 2 AM ET
asset classesUS equities
coverageall tickers
historylive value only
nullableyes

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": "issuer_country = '"'"'cn'"'"'"
  }'

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": "issuer_country = '"'"'cn'"'"'",
    "target_url": "https://example.com/hooks/tickerbot"
  }'

Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.