Success
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
Response
200
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-sandbox.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-sandbox.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
Get key market indicators for a market (TASI, NOMU, breadth metrics).
Returns the primary market indicators for the specified exchange:
index level (e.g. TASI for Tadawul, NOMU for the parallel market),
market breadth (advancing / declining / unchanged), and volume metrics.
Tip: For a full market data record (OHLCV + change) use
GET /markets/{marketId}/data. For sector-level breakdowns use
GET /markets/{marketId}/sectors.
get
https://api-sandbox.argaam.com/api/v1.1/markets/{marketId}/indicators
Path Parameters
marketIdinteger(int32)required
Market ID (e.g. 1 for Saudi Tadawul).
Example:3
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
Standardized successful API response wrapper for v1.0.0 endpoints.
* Additional properties are NOT allowed.
successboolean
Always true for successful responses.
apiVersionstring | null
Semantic API version (e.g., “1.0.0”).
timestampstring(date-time)
UTC timestamp when the response was generated.
requestIdstring | null
Unique request identifier for tracing.
data
The response payload.
metaobject
Pagination and metadata information for collection responses.
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
Rate limit information returned with each response.
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/markets/{marketId}/indicators
Authentication
Path Parameters
200 application/json
Latest value of the Argaam Petrochemical Price Index.
Returns the current index level plus daily / weekly / monthly
changes. Drop into a header ticker on a sector dashboard.
Example
GET /api/v1.1/petrochemicals/index
get
https://api-sandbox.argaam.com/api/v1.1/petrochemicals/index
Response
200 application/json
Response
200 application/json
Success
PetrochemicalPriceIndex
* Additional properties are NOT allowed.
datestring(date-time)
priceValuenumber | null(double)
changenumber | null(double)
get/api/v1.1/petrochemicals/index
Authentication
200 application/json