Search
K
Macroeconomic Layer API (Sandbox)

List prices

Returns the prices available on this layer.

get
https://api-sandbox.argaam.com/api/v1.1/consumer-goods/prices

Response

200 application/json

Success

array
get/api/v1.1/consumer-goods/prices
 
200 application/json

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-sandbox.argaam.com/api/v1.1/consumer-goods/{materialId}/prices

Path Parameters

materialIdinteger(int32)required

Material ID from /.

Response

200 application/json

Success

array
get/api/v1.1/consumer-goods/{materialId}/prices
 
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-sandbox.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

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
 
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-sandbox.argaam.com/api/v1.1/indicators/groups

Response

200

Success

get/api/v1.1/indicators/groups
 
200

Get fields for a group

Returns the fields for the group identified by groupId.

get
https://api-sandbox.argaam.com/api/v1.1/indicators/groups/{groupId}/fields

Path Parameters

groupIdinteger(int32)required

Economic indicator group identifier.

Response

200

Success

get/api/v1.1/indicators/groups/{groupId}/fields
 
200