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
List refining margins
Returns the refining margins available on this layer.
Bound the result with the from and to date parameters.
get
https://api-sandbox.argaam.com/api/v1.1/commodities/refining-margins
Query Parameters
Response
200 application/json
Response
200 application/json
Success
* Additional properties are NOT allowed.
commodityIDinteger(int32)
commodityNameEnstring | null
commodityNameArstring | null
forDatestring(date-time)
pricenumber | null(double)
get/api/v1.1/commodities/refining-margins
Authentication
Query Parameters
200 application/json
Catalogue of all tracked consumer goods (materials).
Returns the full taxonomy: material id, name (Ar/En),
category (food, beverages, building, fuel, etc.), unit, and
reference region.
Example
GET /api/v1.1/consumer-goods
get
https://api-sandbox.argaam.com/api/v1.1/consumer-goods
Response
200 application/json
Response
200 application/json
Success
array
get/api/v1.1/consumer-goods
Authentication
200 application/json
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
Response
200 application/json
Success
array
get/api/v1.1/consumer-goods/prices
Authentication
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
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-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
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