Search
K
Market Data Layer API (Sandbox)

List gics

Returns the gics available on this layer.

Paginated: use page and pageSize. Set lang to 1 for English or 2 for Arabic.

get
https://api-sandbox.argaam.com/api/v1.1/sectors/gics

Query Parameters

marketIdinteger(int32)

Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.

Default:3

Example:3

languageIdinteger(int32)

Response language: 1 = English, 2 = Arabic. Defaults to 1.

Default:1

Example:2

pageinteger(int32)

1-based page number. Defaults to 1.

Default:1

Example:1

pageSizeinteger(int32)

Number of records per page. Defaults to the endpoint’s standard page size; large values are capped server-side.

Default:10

Example:20

Response

200

Success

get/api/v1.1/sectors/gics
 
200

Get a data by marketId

Returns the data identified by marketId.

get
https://api-sandbox.argaam.com/api/v1.1/sectors/data/{marketId}

Query Parameters

sectorIdinteger(int32)

Numeric sector identifier. Use the sector endpoints to list valid values.

Path Parameters

marketIdinteger(int32)required

Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.

Example:3

Response

200 application/json

Success

* Additional properties are NOT allowed.
marketIDinteger(int32)
sectorIDinteger(int32)
bidstring | null
tradingDatestring | null
openValuenumber | null(double)
closeValuenumber | null(double)
highnumber | null(double)
lownumber | null(double)
changenumber | null(double)
volumenumber | null(double)
amountnumber | null(double)
percentageChangenumber | null(double)
get/api/v1.1/sectors/data/{marketId}
 
200 application/json

Get historical series for a data

Returns the historical series for the data identified by marketId.

Bound the result with the from and to date parameters.

get
https://api-sandbox.argaam.com/api/v1.1/sectors/data/{marketId}/history

Query Parameters

sectorIdinteger(int32)

Numeric sector identifier. Use the sector endpoints to list valid values.

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

marketIdinteger(int32)required

Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.

Example:3

Response

200 application/json

Success

* Additional properties are NOT allowed.
marketIDinteger(int32)
sectorIDinteger(int32)
bidstring | null
tradingDatestring | null
openValuenumber | null(double)
closeValuenumber | null(double)
highnumber | null(double)
lownumber | null(double)
volumenumber | null(double)
get/api/v1.1/sectors/data/{marketId}/history
 
200 application/json

MarketSector

object
* Additional properties are NOT allowed.
marketIDinteger(int32)
sectorIDinteger(int32)
bidstring
sectorNameArstring
sectorNameEnstring
Example

SectorData

object
* Additional properties are NOT allowed.
marketIDinteger(int32)
sectorIDinteger(int32)
bidstring
tradingDatestring
openValuenumber(double)
closeValuenumber(double)
highnumber(double)
lownumber(double)
changenumber(double)
volumenumber(double)
amountnumber(double)
percentageChangenumber(double)
Example