GET /api/v1/us/companies

Returns metadata for US public companies including CIK, ticker, name, exchange, industry, and sector.

Request

GET /api/v1/us/companies

Headers

Header	Value
F-API-KEY	Your API key

Query Parameters

Parameter	Type	Required	Filter	Description
cik	string	No	exact	SEC CIK
ticker	string	No	exact	Stock ticker
exchange	string	No	exact	Exchange (NYSE, NASDAQ, etc.)
industry	string	No	exact	Industry
sector	string	No	exact	Sector
name	string	No	like	Company name (fuzzy match)
limit	integer	No	—	Max rows per page (default 100, max 1000)
offset	integer	No	—	Rows to skip (default 0)
sort	string	No	—	Sort field (default ticker)
order	asc | desc	No	—	Sort direction (default asc)

Example

curl -H "F-API-KEY: fk-xxxxx" \
  "https://finance-api.xp-java.workers.dev/api/v1/us/companies?ticker=AAPL"

Response

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "cik": "0000320193",
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "exchange": "NASDAQ",
      "industry": "Consumer Electronics",
      "sector": "Technology",
      "updated_at": "2024-12-31T00:00:00Z"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 100,
    "offset": 0,
    "has_more": false
  }
}