Overview

Data overview

How the datasets fit together, and the identifiers that join them.

Identifiers

Object	ID	Example
Company	Tadawul `symbol` (ISIN also accepted)	`2222`
Document	`doc_`	`doc_7Hk2pQ`
Figure	`fct_`	`fct_9Qm2Lx`
Earnings call	`call_`	`call_3Fn8xR`
Announcement	`ann_`	`ann_51Vb3k`
Economic series	dotted `key`	`gastat.cpi.headline`

How it links up

A company has documents, earnings calls, announcements, dividends and prices, all filtered by symbols.
A document has pages, text, a summary and the figures printed in it. A financial report also has notes, each with its own text and tables.
A figure in a note carries its note_title, so you can go from a number to the note that explains it.
A statement line links to its figure with fact_id, and the figure to its document_id, page and bbox.
Dividends, corporate actions and stock events link to the announcement that disclosed them.
An earnings call links to its presentation with presentation_id.

Conventions

Field names are snake_case.
Money is in SAR unless currency says otherwise. Values are in base units: 21802045000, not "21.8bn".
Trading dates are Riyadh dates (YYYY-MM-DD). Timestamps are UTC ISO 8601 with a Z.
Percentages named *_percent are percent (0.71 = 0.71%). Ratios such as roe and dividend_yield are fractions (0.214 = 21.4%).

Datasets

Companies

Free

Every Saudi listed company, with Arabic and English names, sectors and share counts.

Market data

Free

Quotes, adjusted OHLCV history, indices and market breadth for Tadawul.

Realtime & streaming

Pro+

Live quotes, every trade and the order book, over REST or WebSocket.

Fundamentals

Starter+

Statements standardised or as reported, every footnote, and 5.1M+ figures traced to their page.

Dividends & corporate actions

Starter+

Cash dividends, bonus shares, rights issues, buybacks and stock events.

Filings & reports

Free

Financial reports, board reports and prospectuses, with page text, notes and summaries.

Board reports

Starter+

The board of directors’ annual report, split into chapters: governance, pay, related parties, risks.

Presentations

Free

Investor and earnings decks, page by page.

Earnings calls

Pro+

Recordings and word-timed transcripts, split by speaker and section.

Announcements

Starter+

Every issuer announcement on Tadawul, full text, searchable.

Economic data

Business+

GASTAT, SAMA and Tadawul statistics as clean time series.

← Previous

Quickstart

Plans and limits

Overview

Data overview

How the datasets fit together, and the identifiers that join them.

Identifiers

Object	ID	Example
Company	Tadawul `symbol` (ISIN also accepted)	`2222`
Document	`doc_`	`doc_7Hk2pQ`
Figure	`fct_`	`fct_9Qm2Lx`
Earnings call	`call_`	`call_3Fn8xR`
Announcement	`ann_`	`ann_51Vb3k`
Economic series	dotted `key`	`gastat.cpi.headline`

How it links up

A company has documents, earnings calls, announcements, dividends and prices, all filtered by symbols.
A document has pages, text, a summary and the figures printed in it. A financial report also has notes, each with its own text and tables.
A figure in a note carries its note_title, so you can go from a number to the note that explains it.
A statement line links to its figure with fact_id, and the figure to its document_id, page and bbox.
Dividends, corporate actions and stock events link to the announcement that disclosed them.
An earnings call links to its presentation with presentation_id.

Conventions

Field names are snake_case.
Money is in SAR unless currency says otherwise. Values are in base units: 21802045000, not "21.8bn".
Trading dates are Riyadh dates (YYYY-MM-DD). Timestamps are UTC ISO 8601 with a Z.
Percentages named *_percent are percent (0.71 = 0.71%). Ratios such as roe and dividend_yield are fractions (0.214 = 21.4%).