Macroeconomic Layer API (Production)

Historical quotes for a "regular" commodity.

Returns end-of-day archive prices for the supplied commodity
across the requested date window.

Example

GET /api/v1.1/commodities/1/quotes/regular/history?from=2024-01-01&to=2024-01-31
get
https://api.argaam.com/api/v1.1/commodities/{commodityId}/quotes/regular/history

Query Parameters

fromstring

Start date (yyyy-MM-dd). Default: yesterday.

Example:2024-01-01

tostring

End date (yyyy-MM-dd). Default: today.

Example:2024-03-31

Path Parameters

commodityIdinteger(int32)required

Commodity identifier (e.g., 1 for Brent).

Response

200 application/json

Success

* Additional properties are NOT allowed.
commodityIDinteger(int32)
commodityNameEnstring | null
commodityNameArstring | null
forDatestring(date-time)
openValuenumber | null(double)
closeValuenumber | null(double)
highnumber | null(double)
lownumber | null(double)
get/api/v1.1/commodities/{commodityId}/quotes/regular/history
 
200 application/json

Get historical series for a commodity

Returns the historical series for the commodity identified by commodityId.

Bound the result with the from and to date parameters.

get
https://api.argaam.com/api/v1.1/commodities/{commodityId}/quotes/other/history

Query Parameters

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

commodityIdinteger(int32)required

Numeric commodity identifier. Use GET /api/v1.1/commodities for valid values.

Response

200 application/json

Success

* Additional properties are NOT allowed.
commodityIDinteger(int32)
commodityNameEnstring | null
commodityNameArstring | null
regionNameArstring | null
regionNameEnstring | null
forDatestring(date-time)
averageValuenumber | null(double)
highnumber | null(double)
lownumber | null(double)
get/api/v1.1/commodities/{commodityId}/quotes/other/history
 
200 application/json

Shipping rates / freight prices for a commodity.

Returns chartered / spot shipping prices. Useful for
landed-cost analysis when modeling regional trade flows.

Example

GET /api/v1.1/commodities/1/shipping?from=2024-01-01&to=2024-01-31
get
https://api.argaam.com/api/v1.1/commodities/{commodityId}/shipping

Query Parameters

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

commodityIdinteger(int32)required

Numeric commodity identifier. Use GET /api/v1.1/commodities for valid values.

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/{commodityId}/shipping
 
200 application/json

List refining margins

Returns the refining margins available on this layer.

Bound the result with the from and to date parameters.

get
https://api.argaam.com/api/v1.1/commodities/refining-margins

Query Parameters

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

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
 
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.argaam.com/api/v1.1/consumer-goods

Response

200 application/json

Success

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