materialIdinteger(int32)required
Material ID from /.
Latest price for a specific material.
Single-material variant of /prices. Returns the most
recent quote plus daily change.
Example
GET /api/v1.1/consumer-goods/42/prices
get
https://api.argaam.com/api/v1.1/consumer-goods/{materialId}/prices
Path Parameters
Response
200 application/json
Response
200 application/json
Success
array
get/api/v1.1/consumer-goods/{materialId}/prices
Authentication
Path Parameters
200 application/json
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
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
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