Market Data Layer API (Production)
Search and list companies (paged).
Returns a paginated, searchable list of all companies available
in the Argaam database.
Search using the ?q= parameter — it matches against company
name (both Arabic and English) and ticker symbol.
Filter by market using ?marketIds=1,2,4 (comma-separated).
Pagination is controlled by ?page= (1-based) and ?pageSize=.
Each result record contains: CompanyID, CompanyNameEn,
CompanyNameAr, MarketName, Ticker, and LogoURL.
Tip: Once you have a company ID, retrieve its full profile with
GET /companies/{id}/profile. To look up by ticker symbol use
GET /companies/by-symbol/{symbol}.
get
https://api.argaam.com/api/v1.1/companies
Query Parameters
langinteger(int32)
Language ID: 1 = English (default), 2 = Arabic. Defaults to 1.
Default:1
Example:1
qstring
Search term (optional). Matched against name and ticker.
Default:
Example:[ "" ]
pageinteger(int32)
Page number (1-based). Default: 1. Defaults to 1.
Default:1
Example:1
pageSizeinteger(int32)
Records per page. Default: 20. Defaults to 20.
Default:20
Example:20
userIdinteger(int32)
Optional user ID for personalized watchlist data. Default: 0. Defaults to 0.
Default:0
Example:0
marketIdsstring
Comma-separated market IDs to filter by (e.g. 1,2). Default: all markets.
Default:
Example:1
Response
200 application/json
Response
200 application/json
Success
ApiV1Response2
Standardized successful API response wrapper for v1.0.0 endpoints.
* Additional properties are NOT allowed.
successboolean
Always true for successful responses.
apiVersionstring | null
Semantic API version (e.g., “1.0.0”).
timestampstring(date-time)
UTC timestamp when the response was generated.
requestIdstring | null
Unique request identifier for tracing.
data
The response payload.
metaobject
Pagination and metadata information for collection responses.
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
Rate limit information returned with each response.
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies
Authentication
Query Parameters
200 application/json
Look up a company by its trading symbol (ticker).
Resolves a ticker symbol to the full company profile. Useful for
building widgets where the user types in a symbol (e.g. 2222,
SABIC) and you need the canonical company ID and metadata.
The symbol match is case-insensitive.
Returns 404 when no company with the given symbol is found.
Tip: For shareholders by symbol use
GET /companies/by-symbol/{symbol}/shareholders.
For analyst estimates by symbol use
GET /companies/by-symbol/{symbol}/analyst-estimates.
get
https://api.argaam.com/api/v1.1/companies/by-symbol/{symbol}
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.
Default:3
Example:3
Path Parameters
symbolstringrequired
Company ticker symbol, e.g. 2222. Equivalent to stockSymbol on other endpoints.
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/by-symbol/{symbol}
Authentication
Path Parameters
Query Parameters
200 application/json
Get the latest price for a company
Returns the most recent traded price for the company, with change, volume and turnover. Near real-time: values are delayed per the Tadawul distribution agreement.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/price
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
Path Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/price
Authentication
Path Parameters
Query Parameters
200 application/json
Get the intraday price series for a company
Returns today’s intraday price points for the company, ordered oldest to newest. Intended for intraday charts; use the history endpoint for end-of-day series.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/price/intraday
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
Path Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/price/intraday
Authentication
Path Parameters
Query Parameters
200 application/json
Get the historical price series for a company
Returns end-of-day OHLC price history for the company. Bound the result with from/to or period - unbounded calls return the full available history and are heavily rate limited.
Bound the result with the from and to date parameters.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/price/history
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
fromstring
Start of the date range, inclusive. Format YYYY-MM-DD.
Example:2024-01-01
tostring
End of the date range, inclusive. Format YYYY-MM-DD.
Example:2024-03-31
Path Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/price/history
Authentication
Path Parameters
Query Parameters
200 application/json