Company

Ticker resolution

GET/api/v2/tickers

Coverage: US / CN / JP
Billing: 20 cr / thousand calls

The entry point for the other ticker-scoped endpoints: one canonical ticker per row; passing query selects resolve mode, omitting it selects list mode.

Resolve mode (with query): exact match column by column against the name, code and identifier columns (case-insensitive, no prefix or substring matching; AAPL does not pull in ETFs whose name contains AAPL); matching rows are returned in ascending ticker order, up to limit rows. There is usually only one row; multiple rows occur only in cases such as multiple listings under the same name. Only currently trading codes are matched; a delisted code does not resolve.
List mode (without query): returns the full set of currently trading common stock codes, filtered by market and paginated in ascending ticker order.

Scope is US / CN / JP only; any other value passed in market returns 400 ; HK / KR / TW companies also do not appear in the results.

Query parameters

Parameter	Type	Required	Description
query	string	optional	Name / code / ISIN / CIK / CUSIP, exact match (case-insensitive, leading and trailing whitespace ignored); omitting it enters list mode.
market	string	optional	US CN JP, comma-separated for multiple values. Default All.
limit	int	optional	Maximum 50 in resolve mode; maximum 500 in list mode. Default 10 (resolve) / 500 (list).
page	int	optional	Applies to list mode only (starting from 1). Resolve mode is not paginated: page=1 is ignored (many SDKs send it by default), page>1 returns 400. Default 1.

Sorted ticker asc. Paged with limit and page (pages start at 1); fewer rows than limit means the last page.

Response fields

Field	Type	Description
ticker	string	canonical ticker
market	string	US / CN / JP
name	string	Company name, identical to name in /company-profile (English name for US / JP, mostly a Chinese name for CN)
exchange	string	Exchange MIC (ISO 10383): XNAS XNYS XASE XSHG XSHE BJSE XTKS
identifiers	string	External identifiers, null when there is no value; only US-listed companies have CIK and CUSIP values

Request

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/tickers?query=Apple%20Inc.&market=US"

Response · 200

{
  "data": [
    {
      "ticker": "AAPL",
      "market": "US",
      "name": "Apple Inc.",
      "exchange": "XNAS",
      "identifiers": {
        "isin": "US0378331005",
        "cik": "0000320193",
        "cusip": "037833100"
      }
    }
  ]
}

No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.

Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.