llms.txt
Compare with other sites' llms.txt files →# Axiora
> Japanese financial data from company filings, for analysts and platforms working on Japanese companies. Records from official EDINET and TDnet filings (financials, ownership, capital, governance, filing text); rows read from a single filing carry its `doc_id`.
Base URL: https://api.axiora.dev
Auth: `Authorization: Bearer ax_live_YOUR_KEY` (free key at https://axiora.dev/en/login)
Envelope: `{ "data": ..., "meta": { total, limit, offset, next_cursor, request_id } }`
Errors: `{ "error": { "code", "message", "details" }, "meta": { "request_id" } }`
Conventions: JPY integers, ISO 8601 dates, EDINET code (E12345) or 4-digit securities code (7203) as `{code}`, fiscal year named by its end year.
Paging: `limit`, `offset`, or `cursor` from `meta.next_cursor`. Replay: pass `meta.as_of` back as `?as_of=` for the same rows later.
## Start here
- [Connect an agent](https://axiora.dev/agents.md): MCP setup per client, REST, a first query
- [Agent skill](https://axiora.dev/skill.md): authenticate, resolve IDs, read a row, handle errors
- [Full reference as text](https://axiora.dev/llms-full.txt): every endpoint with parameters and data models
- [OpenAPI](https://axiora.dev/openapi.json)
- [Pricing](https://axiora.dev/pricing.md)
- [API overview](https://axiora.dev/api.md)
- Pages as markdown (also under /ja/, or request the page with `Accept: text/markdown`): [Home](https://axiora.dev/en.md), [Pricing](https://axiora.dev/en/pricing.md), [Docs](https://axiora.dev/en/docs.md); coverage: [Financials](https://axiora.dev/en/docs/coverage/financials.md), [Translations](https://axiora.dev/en/docs/coverage/translations.md), [Filings](https://axiora.dev/en/docs/coverage/filings.md), [Ownership](https://axiora.dev/en/docs/coverage/ownership.md), [Governance](https://axiora.dev/en/docs/coverage/governance.md), [Earnings](https://axiora.dev/en/docs/coverage/earnings.md)
- [Docs](https://axiora.dev/en/docs), [Quickstart](https://axiora.dev/en/docs/quickstart), [Reference](https://axiora.dev/en/docs/reference)
- MCP server: https://api.axiora.dev/mcp (read-only tools; same key, or OAuth). [Setup](https://axiora.dev/en/docs/mcp)
## Resolve identifiers
- GET /v1/identifiers?id= : any EDINET code, securities code or investor id, returns roles and links
- POST /v1/batch/identifiers : up to 100 ids; misses listed in `meta.unresolved`
- GET /v1/companies/search?q= : companies by name or code
- GET /v1/investors/search?q= : filers and holders by name
- GET /v1/companies/{code}/identifiers
## Companies and financials
- GET /v1/companies : list (sector, name, securities_code, since)
- GET /v1/companies/{code} : profile (expand, years, peer_limit)
Each expand value needs the plan of the route that serves it: on Free, financials and ratios; growth, health_score, segments and translations need Developer. A value is open wherever its own route is open to your key for that company; when it is not: 403 TIER_REQUIRED when named, left out of expand=all and listed in meta.expand_withheld. Peers list each company's identity with figures null.
- GET /v1/companies/{code}/financials : statements (years, fields, doc_type, doc_id, include)
- GET /v1/companies/{code}/ratios, /v1/companies/{code}/growth (years, split_adjusted)
- GET /v1/companies/{code}/health
- GET /v1/companies/{code}/peers, GET /v1/compare?codes=, GET /v1/timeseries?codes=&metric=
- GET /v1/screen : filter by roe, roa, revenue, net_income, operating_income, sector
- GET /v1/rankings/{metric}, GET /v1/sectors, GET /v1/sectors/{sector_name}
- POST /v1/batch/financials
## Ownership (large-shareholding reports, 大量保有報告書)
- GET /v1/companies/{code}/shareholdings : filings against one issuer
- GET /v1/shareholdings/latest
- GET /v1/shareholdings/{shareholding_id}/audit : the filing chain behind one row
- GET /v1/companies/{code}/ownership/trajectories : per-filer position history (as_of)
- GET /v1/companies/{code}/ownership/trajectories/{filer_code}
- GET /v1/companies/{code}/ownership/trajectories/{filer_code}/probabilities
- GET /v1/companies/{code}/ownership/chart, GET /v1/companies/{code}/ownership/network
- GET /v1/companies/{code}/ownership/signals, GET /v1/ownership/signals : detected changes
- GET /v1/ownership/movers : largest recent accumulations and exits
- GET /v1/ownership/activist-campaigns
- GET /v1/ownership/cross-holdings, GET /v1/ownership/unwinding-scoreboard
- GET /v1/ownership/probability-table
- GET /v1/investors/{code}/positions : every issuer one investor holds
## Capital and buybacks
- GET /v1/companies/{code}/capital-allocation, GET /v1/capital-allocation/ranking
- GET /v1/companies/{code}/buybacks, GET /v1/companies/{code}/buybacks/analysis
- GET /v1/buybacks/latest, GET /v1/buybacks/accelerations
## Earnings (TDnet 決算短信)
- GET /v1/companies/{code}/earnings, GET /v1/companies/{code}/earnings/surprise
- GET /v1/companies/{code}/forecasts, GET /v1/companies/{code}/forecast-revisions
- GET /v1/companies/{code}/earnings/signals, GET /v1/earnings/signals
- GET /v1/earnings/latest
## Governance and relationships
- GET /v1/companies/{code}/board, GET /v1/companies/{code}/voting, GET /v1/voting/recent
- GET /v1/companies/{code}/relationships, GET /v1/companies/{code}/relationships/interlocks
- GET /v1/relationships/interlocks, GET /v1/companies/{code}/subsidiaries
## Filings and text
- GET /v1/filings : EDINET document index (date_from, date_to, company_code, doc_type, since). date_from and date_to filter period_end (the fiscal period date, fiscal year end for annual and semi-annual reports), not the filing date; for recent filings use since (receipt time) and check filed_at
- GET /v1/filings/calendar?month=, GET /v1/filings/{doc_id}
- GET /v1/filings/{doc_id}/sections, GET /v1/companies/{code}/sections, GET /v1/sections/available
- GET /v1/filings/{doc_id}/translations, GET /v1/translations/search?q=
- GET /v1/filings/{doc_id}/fund-registration, GET /v1/filings/{doc_id}/internal-control
## Bulk
- GET /v1/bulk/financials.csv, GET /v1/bulk/financials.json
- GET /v1/bulk/ownership_trajectories.parquet, GET /v1/bulk/ownership_signals.parquet
## Field definitions
- GET /v1/ontology/version, GET /v1/ontology/fields, GET /v1/ontology/fields/{field_name}
## Account and status
- GET /v1/usage
- GET /v1/webhooks, POST /v1/webhooks, DELETE /v1/webhooks/{webhook_id}
- GET /v1/coverage, GET /v1/freshness, GET /v1/health, GET /v1/health/deep
## API v2 (preview): entities, facts, types
- GET /v2/companies/{code}, GET /v2/holders/{holder_code} : any identifier in; one canonical id out
- GET /v2/positions?company=&holder=, GET /v2/facts?type=&entity=, GET /v2/changes?since=
- GET /v2/entities?type=, GET /v2/entities/{entity_id}, GET /v2/search?q=, GET /v2/types
- GET /v2/filings, GET /v2/filings/{doc_id}
- Ids: `company:<EDINET code>` (company:E00883), `holder:<EDINET code>` when the holder has one (holder:E06485), else an Axiora key; `filing:<doc_id>`. Ids are issued once and never reused.
- Any identifier works on input: EDINET code, securities code (4452 or 44520), 法人番号, LEI, and every v1 id (AXIORA_NOMURA_AM). `meta.resolved_from` names what you sent when it was not the canonical id; `ids` on every entity lists the codes we hold.
- A moved id answers with its successor; a split or retired id answers 410 with `details.successors`; a v1 id that only named unidentified co-holders answers 410 `HOLDER_NOT_IDENTIFIED`.
## Paths named in earlier versions of this file
- /v1/companies/{code}/ownership : use /v1/companies/{code}/ownership/trajectories
- /v1/investors/{filer_code} and /v1/investors/{filer_code}/portfolio : use /v1/investors/{code}/positions
## Not for
Real-time prices, order books or trade execution.