fromstring
Start date (yyyy-MM-dd). Defaults to yesterday.
Example:2024-01-01
tostring
End date (yyyy-MM-dd). Defaults to today.
Example:2024-03-31
Historical prices for a specific material.
Time series for trend analysis. Returns end-of-day archive
prices over the requested window.
Example
GET /api/v1.1/consumer-goods/42/prices/history?from=2023-01-01&to=2023-12-31
get
https://api.argaam.com/api/v1.1/consumer-goods/{materialId}/prices/history
Query Parameters
Path Parameters
materialIdinteger(int32)required
Material ID.
Response
200 application/json
Response
200 application/json
Material name and a list of date/price observations for the requested window.
ConsumerGoodPriceHistoryResponse
Price history for a single material.
* Additional properties are NOT allowed.
materialIDinteger(int32)
materialNameArstring | null
materialNameEnstring | null
pricesarray | null[object]
A single date-price observation in a history series.
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/consumer-goods/{materialId}/prices/history
Authentication
Path Parameters
Query Parameters
200 application/json
List all indicator groups.
Returns the catalogue of groups (e.g., Saudi GDP, UAE
inflation, GCC monetary aggregates). Each entry includes
id, name (Ar/En), country, frequency, and field count.
Example
GET /api/v1.1/indicators/groups
get
https://api.argaam.com/api/v1.1/indicators/groups
Response
200
Response
200
Success
get/api/v1.1/indicators/groups
Authentication
200
Get fields for a group
Returns the fields for the group identified by groupId.
get
https://api.argaam.com/api/v1.1/indicators/groups/{groupId}/fields
Path Parameters
groupIdinteger(int32)required
Economic indicator group identifier.
Response
200
Response
200
Success
get/api/v1.1/indicators/groups/{groupId}/fields
Authentication
Path Parameters
200
Get an economic indicator series
Returns the observation series for a single indicator field within a group - the actual macroeconomic time series.
get
https://api.argaam.com/api/v1.1/indicators/groups/{groupId}/fields/{fieldId}/values
Query Parameters
yearinteger(int32)
Calendar year to filter by, e.g. 2025. Defaults to 0.
Default:0
Example:2023
periodstring
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
fiscalPeriodstring
Fiscal period within the year: 1-4 for quarters, 5 for the full year.
Default:
Example:year
Path Parameters
groupIdinteger(int32)required
Economic indicator group identifier.
fieldIdinteger(int32)required
Identifier of a field inside the selected indicator group.
Response
200
Response
200
Success
get/api/v1.1/indicators/groups/{groupId}/fields/{fieldId}/values
Authentication
Path Parameters
Query Parameters
200
Get key market indicators for a market (TASI, NOMU, breadth metrics).
Returns the primary market indicators for the specified exchange:
index level (e.g. TASI for Tadawul, NOMU for the parallel market),
market breadth (advancing / declining / unchanged), and volume metrics.
Tip: For a full market data record (OHLCV + change) use
GET /markets/{marketId}/data. For sector-level breakdowns use
GET /markets/{marketId}/sectors.
get
https://api.argaam.com/api/v1.1/markets/{marketId}/indicators
Path Parameters
marketIdinteger(int32)required
Market ID (e.g. 1 for Saudi Tadawul).
Example:3
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
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/markets/{marketId}/indicators
Authentication
Path Parameters
200 application/json