Overview
Returns a single flat company block, deliberately small.
Field semantics are normalized across markets — sector and
industry map to the GICS code for US, the EDINET 業種 for
JP, and the DART industry classification for KR (re-keyed into
GICS-equivalent labels for cross-market grouping).
regulator / regulator_id is the cross-market
generalization of the CIK: the SEC CIK for US, the DART corp_code for
KR (EDINET filer codes for JP are pending). filings_url
deep-links to the company's page at its regulator when one exists.
The fiscal_year_end field is the reporting calendar in
MM-DD form. Most US filers use 12-31; Apple uses
09-26; Toyota uses 03-31 (Japanese fiscal
year). When interpreting period strings from financial endpoints, this
anchors which quarter is "Q1".
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | path | yes | Market-native format. See Ticker format. |
Example
curl -H "X-API-Key: rk_YOUR_KEY" \
https://api.rockmoon.ai/v1/company/AAPL
import requests
r = requests.get(
"https://api.rockmoon.ai/v1/company/AAPL",
headers={"X-API-Key": "rk_YOUR_KEY"},
)
company = r.json()["company"]
const r = await fetch("https://api.rockmoon.ai/v1/company/AAPL", {
headers: { "X-API-Key": "rk_YOUR_KEY" },
});
const { company } = await r.json();
Response 200
{
"ticker": "AAPL",
"market": "US",
"company": {
"name": "Apple Inc.",
"name_local": null,
"exchange": "Nasdaq",
"currency": "USD",
"sector": "Technology",
"industry": "Consumer Electronics",
"fiscal_year_end": "09-26",
"is_active": true,
"listed_date": "2009-07-22",
"delisted_date": null,
"location": "CUPERTINO, CA",
"regulator": "SEC",
"regulator_id": "0000320193",
"isin": null,
"filings_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193"
}
}
Errors
| HTTP | Code | Cause |
|---|---|---|
| 404 | ticker_not_found | Ticker is not in coverage (delisted, foreign issuer, or not yet ingested). |
| 401 | missing_api_key | No key supplied. |
Notes
- Re-ticker: companies that have changed ticker (FB → META) resolve under both the old and new symbol — the response always carries the current ticker.
- CIK only: for US, you can substitute
cik=0000320193as a query parameter on the search endpoint as an alternative resolution path when ticker is ambiguous. - Currency: the
currencyfield is the reporting currency, not necessarily the trading currency. Most filers match (USD-USD, JPY-JPY, KRW-KRW); rare exceptions (US ADRs of foreign issuers) report in the home currency.