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
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
Path Parameters
commodityIdinteger(int32)required
Numeric commodity identifier. Use GET /api/v1.1/commodities for valid values.
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/{commodityId}/shipping
Authentication
Path Parameters
Query Parameters
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
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.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.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.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