Tarutha API reference

The Tarutha REST API for Indonesian market data: IDX equities and indices, KSEI ownership, government bonds and mutual funds. Read every route, parameter and response without a key.

Data routes need a bearer key. Keys come with a paid membership. The pricing section explains how to join.

Quickstart

Get an API key. Keys come with a Tarutha founding membership: see tarutha.co/#pricing to join. Members sign in to the Terminal at https://app.tarutha.co and create keys from the account menu. Keys look like tarutha_…. Keep them secret and use them only on a server.
Authenticate every request. Send Authorization: Bearer tarutha_…. Only this specification (/v1/openapi.json) and /v1/status answer without a key. Also send your own User-Agent header, because some default library user agents, such as Python's urllib, are refused at our network edge.
Mind the limit. A member's keys share 300 requests a minute. Above that the API answers 429 with the code RATE_LIMITED and a Retry-After header.
Discover. Hit GET /v1/equities to see every ticker you can query (~970 IDX-listed names).
Drill in. For any ticker:
- GET /v1/equities/{ticker}: the company profile
- GET /v1/equities/{ticker}/prices: daily OHLCV history
- GET /v1/equities/{ticker}/fundamentals: market cap, P/E, analyst targets…
- GET /v1/equities/{ticker}/ownership: insider/institutional holders
Zoom out. GET /v1/indices (IHSG & 44 more), GET /v1/movers (daily gainers/losers with foreign flow), GET /v1/idx/disclosures, GET /v1/ksei/corporate-actions (dividend/rights schedules).
Go deep. GET /v1/idx/securities (listing master), GET /v1/idx/uma + GET /v1/idx/suspensions (risk flags), GET /v1/idx/broker-summary (daily broker flow), GET /v1/idx/corporate-actions (dilution history), GET /v1/idx/ipo (pipeline), GET /v1/idx/financial-reports (XBRL/PDF filings), GET /v1/ksei/announcements (new-instrument registrations), GET /v1/ksei/archives + GET /v1/ksei/statistics-pdfs (monthly depository snapshots to 2012).