---
title: "Market Data Layer API"
url: "https://developer.argaam.com/apis/market-data-layer-api-sandbox-v1/versions/76611d79-bb1b-44da-aed6-aca8b510fd74"
---

# Market Data Layer API

OpenAPI specification document.

```json
{"openapi":"3.0.1","info":{"title":"Market Data Layer API","description":"Near real-time and historical market data for Tadawul and international equities and indices. Company quotes, intraday and end-of-day price history, market and sector performance, top movers, and stock classifications.","contact":{"name":"Argaam IT","url":"https://www.argaam.com","email":"developer@argaam.com"},"version":"v1.1"},"paths":{"/api/v1.1/companies":{"get":{"tags":["Companies"],"parameters":[{"name":"lang","in":"query","description":"Language ID: `1` = English (default), `2` = Arabic. Defaults to `1`.","schema":{"type":"integer","format":"int32","default":1},"example":1},{"name":"q","in":"query","description":"Search term (optional). Matched against name and ticker.","schema":{"type":"string","default":""},"example":""},{"name":"page","in":"query","description":"Page number (1-based). Default: `1`. Defaults to `1`.","schema":{"type":"integer","format":"int32","default":1},"example":1},{"name":"pageSize","in":"query","description":"Records per page. Default: `20`. Defaults to `20`.","schema":{"type":"integer","format":"int32","default":20},"example":20},{"name":"userId","in":"query","description":"Optional user ID for personalized watchlist data. Default: `0`. Defaults to `0`.","schema":{"type":"integer","format":"int32","default":0},"example":0},{"name":"marketIds","in":"query","description":"Comma-separated market IDs to filter by (e.g. `1,2`). Default: all markets.","schema":{"type":"string","default":""},"example":"1"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response2"}}}}},"summary":"Search and list companies (paged).","description":"Returns a paginated, searchable list of all companies available\r\nin the Argaam database.\r\n            \r\n**Search** using the `?q=` parameter — it matches against company\r\nname (both Arabic and English) and ticker symbol.\r\n            \r\n**Filter by market** using `?marketIds=1,2,4` (comma-separated).\r\n            \r\n**Pagination** is controlled by `?page=` (1-based) and `?pageSize=`.\r\n            \r\nEach result record contains: `CompanyID`, `CompanyNameEn`,\r\n`CompanyNameAr`, `MarketName`, `Ticker`, and `LogoURL`.\r\n            \r\n**Tip:** Once you have a company ID, retrieve its full profile with\r\n`GET /companies/{id}/profile`. To look up by ticker symbol use\r\n`GET /companies/by-symbol/{symbol}`.","operationId":"getCompanies"}},"/api/v1.1/companies/by-symbol/{symbol}":{"get":{"tags":["Companies"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Company ticker symbol, e.g. `2222`. Equivalent to `stockSymbol` on other endpoints."},{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values. Defaults to `3`."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Look up a company by its trading symbol (ticker).","description":"Resolves a ticker symbol to the full company profile. Useful for\r\nbuilding widgets where the user types in a symbol (e.g. `2222`,\r\n`SABIC`) and you need the canonical company ID and metadata.\r\n            \r\nThe symbol match is **case-insensitive**.\r\n            \r\nReturns `404` when no company with the given symbol is found.\r\n            \r\n**Tip:** For shareholders by symbol use\r\n`GET /companies/by-symbol/{symbol}/shareholders`.\r\nFor analyst estimates by symbol use\r\n`GET /companies/by-symbol/{symbol}/analyst-estimates`.","operationId":"getCompaniesBySymbolBySymbol"}},"/api/v1.1/companies/{stockSymbol}/price":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get the latest price for a company","description":"Returns the most recent traded price for the company, with change, volume and turnover. Near real-time: values are delayed per the Tadawul distribution agreement.","operationId":"getCompaniesByStockSymbolPrice"}},"/api/v1.1/companies/{stockSymbol}/price/intraday":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get the intraday price series for a company","description":"Returns today's intraday price points for the company, ordered oldest to newest. Intended for intraday charts; use the history endpoint for end-of-day series.","operationId":"getCompaniesByStockSymbolPriceIntraday"}},"/api/v1.1/companies/{stockSymbol}/price/history":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values."},{"name":"from","in":"query","schema":{"type":"string"},"example":"2024-01-01","description":"Start of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"to","in":"query","schema":{"type":"string"},"example":"2024-03-31","description":"End of the date range, inclusive. Format `YYYY-MM-DD`."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get the historical price series for a company","description":"Returns end-of-day OHLC price history for the company. Bound the result with `from`/`to` or `period` - unbounded calls return the full available history and are heavily rate limited.\n\nBound the result with the `from` and `to` date parameters.","operationId":"getCompaniesByStockSymbolPriceHistory"}},"/api/v1.1/companies/{stockSymbol}/stock":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get stock details for a company","description":"Returns the stock details for the company identified by `stockSymbol`.","operationId":"getCompaniesByStockSymbolStock"}},"/api/v1.1/companies/{stockSymbol}/stock/summary":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get summary for a company","description":"Returns the summary for the company identified by `stockSymbol`.","operationId":"getCompaniesByStockSymbolStockSummary"}},"/api/v1.1/companies/{stockSymbol}/sector":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"marketId","in":"query","schema":{"type":"string","default":"3"},"example":"3","description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get the Argaam sector classification for a company.","description":"Returns the company's position in the Argaam industry taxonomy:\r\nsector, sub-sector, and industry group (Arabic + English names).\r\n            \r\nThe Argaam classification is independent of the exchange's own\r\nsector tree and follows GICS-inspired groupings optimized for\r\nGCC markets.\r\n            \r\n**Tip:** For a cross-market sector roster use\r\n`GET /markets/stock-classification`.","operationId":"getCompaniesByStockSymbolSector"}},"/api/v1.1/markets":{"get":{"tags":["Markets"],"parameters":[{"name":"region","in":"query","description":"Region filter: `all` (default), `domestic`, or `international`. Defaults to `all`.","schema":{"type":"string","default":"all"},"example":"all"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"List all markets (domestic and/or international).","description":"Returns the Argaam market catalogue, optionally filtered by region.\r\n            \r\n**Region values**\r\n| Value | Description |\r\n|---|---|\r\n| `all` (default) | Both domestic GCC markets and international indices |\r\n| `domestic` | GCC exchange list only (Tadawul, DFM, ADX, MSM, etc.) |\r\n| `international` | International indices only (NYSE, LSE, Nikkei, etc.) |\r\n            \r\n**Domestic markets** include the numeric `MarketID` used across all other\r\nMarkets and Companies endpoints (e.g. `marketId=1` = Saudi Tadawul).\r\n            \r\n**Tip:** Use `marketId=3` to request consolidated cross-GCC data in other\r\nendpoints — it represents the combined GCC view.","operationId":"getMarkets"}},"/api/v1.1/markets/stock-classification":{"get":{"tags":["Markets"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get the canonical Argaam stock classification list (cross-market).","description":"Returns the complete Argaam stock taxonomy, mapping each listed company\r\nto its stock type (ordinary share, REIT, ETF, preferred share, etc.)\r\nacross all GCC exchanges.\r\n            \r\nThis classification is independent of each exchange's own sector tree\r\nand is used as the master reference for Argaam screeners and heatmaps.\r\n            \r\n**Tip:** For per-company financial ratios across all classified stocks use\r\n`GET /companies/stock-classification/ratios`.\r\nFor exchange-specific sector trees use\r\n`GET /markets/{marketId}/sectors`.","operationId":"getMarketsStockClassification","parameters":[]}},"/api/v1.1/markets/all/companies":{"get":{"tags":["Markets"],"parameters":[{"name":"lang","in":"query","description":"Language ID: `1` = English (default), `2` = Arabic. Defaults to `1`.","schema":{"type":"integer","format":"int32","default":1},"example":1},{"name":"userId","in":"query","description":"Optional user ID for personalized watchlist data. Default: `0`. Defaults to `0`.","schema":{"type":"integer","format":"int32","default":0},"example":0}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response2"}}}}},"summary":"List companies across all markets (cross-market, paged).","description":"Returns a flat list of all companies across every GCC exchange in\r\nthe Argaam database, optionally personalized with watchlist data for\r\na logged-in user.\r\n                       \r\n**Language codes** — `1` = English (default), `2` = Arabic.\r\n            \r\n**Tip:** To restrict to a single exchange use\r\n`GET /markets/{marketId}/companies`. For searchable/pageable listing\r\nuse `GET /companies?marketIds={ids}`.","operationId":"getMarketsAllCompanies"}},"/api/v1.1/sectors/by-market/{marketId}":{"get":{"tags":["Sectors"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"sectorId","in":"query","schema":{"type":"integer","format":"int32"},"description":"Numeric sector identifier. Use the sector endpoints to list valid values."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketSector"}}}}}},"summary":"Get a by market by marketId","description":"Returns the by market identified by `marketId`.","operationId":"getSectorsByMarketByMarketId"}},"/api/v1.1/sectors/argaam":{"get":{"tags":["Sectors"],"parameters":[{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values. Defaults to `3`."},{"name":"languageId","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":2,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":10},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."},{"name":"sectorName","in":"query","schema":{"type":"string","default":""},"example":"","description":"Sector name to filter by, matched exactly as returned by the sector endpoints."}],"responses":{"200":{"description":"Success"}},"summary":"List argaam","description":"Returns the argaam available on this layer.\n\nPaginated: use `page` and `pageSize`. Set `lang` to `1` for English or `2` for Arabic.","operationId":"getSectorsArgaam"}},"/api/v1.1/sectors/gics":{"get":{"tags":["Sectors"],"parameters":[{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values. Defaults to `3`."},{"name":"languageId","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":2,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":10},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success"}},"summary":"List gics","description":"Returns the gics available on this layer.\n\nPaginated: use `page` and `pageSize`. Set `lang` to `1` for English or `2` for Arabic.","operationId":"getSectorsGics"}},"/api/v1.1/sectors/data/{marketId}":{"get":{"tags":["Sectors"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"sectorId","in":"query","schema":{"type":"integer","format":"int32"},"description":"Numeric sector identifier. Use the sector endpoints to list valid values."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SectorData"}}}}}},"summary":"Get a data by marketId","description":"Returns the data identified by `marketId`.","operationId":"getSectorsDataByMarketId"}},"/api/v1.1/sectors/data/{marketId}/history":{"get":{"tags":["Sectors"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"sectorId","in":"query","schema":{"type":"integer","format":"int32"},"description":"Numeric sector identifier. Use the sector endpoints to list valid values."},{"name":"from","in":"query","schema":{"type":"string"},"example":"2024-01-01","description":"Start of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"to","in":"query","schema":{"type":"string"},"example":"2024-03-31","description":"End of the date range, inclusive. Format `YYYY-MM-DD`."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SectorDataArchive"}}}}}},"summary":"Get historical series for a data","description":"Returns the historical series for the data identified by `marketId`.\n\nBound the result with the `from` and `to` date parameters.","operationId":"getSectorsDataByMarketIdHistory"}},"/api/v1.1/markets/{marketId}/data":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get data for a market","description":"Returns the data for the market identified by `marketSymbol`.","operationId":"getMarketsByMarketIdData"}},"/api/v1.1/markets/{marketId}/data/history":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"from","in":"query","schema":{"type":"string"},"example":"2024-01-01","description":"Start of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"to","in":"query","schema":{"type":"string"},"example":"2024-03-31","description":"End of the date range, inclusive. Format `YYYY-MM-DD`."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get historical series for a market","description":"Returns the historical series for the market identified by `marketSymbol`.\n\nBound the result with the `from` and `to` date parameters.","operationId":"getMarketsByMarketIdDataHistory"}},"/api/v1.1/markets/{marketId}/companies":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get companies for a market","description":"Returns the companies for the market identified by `marketSymbol`.","operationId":"getMarketsByMarketIdCompanies"}},"/api/v1.1/markets/international/{marketId}/data":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get data for a international","description":"Returns the data for the international identified by `marketSymbol`.","operationId":"getMarketsInternationalByMarketIdData"}},"/api/v1.1/markets/international/{marketId}/data/history":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"from","in":"query","schema":{"type":"string"},"example":"2024-01-01","description":"Start of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"to","in":"query","schema":{"type":"string"},"example":"2024-03-31","description":"End of the date range, inclusive. Format `YYYY-MM-DD`."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get historical series for a international","description":"Returns the historical series for the international identified by `marketSymbol`.\n\nBound the result with the `from` and `to` date parameters.","operationId":"getMarketsInternationalByMarketIdDataHistory"}},"/api/v1.1/markets/{marketId}/movers":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get top movers for a market","description":"Returns the top movers for the market identified by `marketSymbol`.","operationId":"getMarketsByMarketIdMovers"}},"/api/v1.1/markets/{marketId}/sectors":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"lang","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"sectorName","in":"query","schema":{"type":"string","default":""},"example":"","description":"Sector name to filter by, matched exactly as returned by the sector endpoints."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":10},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response2"}}}}},"summary":"Get sectors for a market","description":"Returns the sectors for the market identified by `marketSymbol`.\n\nPaginated: use `page` and `pageSize`. Set `lang` to `1` for English or `2` for Arabic.","operationId":"getMarketsByMarketIdSectors"}}},"components":{"schemas":{"MarketSector":{"type":"object","properties":{"marketID":{"type":"integer","format":"int32"},"sectorID":{"type":"integer","format":"int32"},"bid":{"type":"string","nullable":true},"sectorNameAr":{"type":"string","nullable":true},"sectorNameEn":{"type":"string","nullable":true}},"additionalProperties":false},"SectorData":{"type":"object","properties":{"marketID":{"type":"integer","format":"int32"},"sectorID":{"type":"integer","format":"int32"},"bid":{"type":"string","nullable":true},"tradingDate":{"type":"string","nullable":true},"openValue":{"type":"number","format":"double","nullable":true},"closeValue":{"type":"number","format":"double","nullable":true},"high":{"type":"number","format":"double","nullable":true},"low":{"type":"number","format":"double","nullable":true},"change":{"type":"number","format":"double","nullable":true},"volume":{"type":"number","format":"double","nullable":true},"amount":{"type":"number","format":"double","nullable":true},"percentageChange":{"type":"number","format":"double","nullable":true}},"additionalProperties":false},"SectorDataArchive":{"type":"object","properties":{"marketID":{"type":"integer","format":"int32"},"sectorID":{"type":"integer","format":"int32"},"bid":{"type":"string","nullable":true},"tradingDate":{"type":"string","nullable":true},"openValue":{"type":"number","format":"double","nullable":true},"closeValue":{"type":"number","format":"double","nullable":true},"high":{"type":"number","format":"double","nullable":true},"low":{"type":"number","format":"double","nullable":true},"volume":{"type":"number","format":"double","nullable":true}},"additionalProperties":false},"ApiV1Meta":{"type":"object","properties":{"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalRecords":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32","readOnly":true},"hasNextPage":{"type":"boolean","readOnly":true},"hasPreviousPage":{"type":"boolean","readOnly":true}},"additionalProperties":false},"ApiV1RateLimit":{"type":"object","properties":{"limit":{"type":"integer","format":"int32"},"remaining":{"type":"integer","format":"int32"},"reset":{"type":"string","format":"date-time"}},"additionalProperties":false},"ApiV1Response":{"type":"object","properties":{"success":{"type":"boolean"},"apiVersion":{"type":"string","nullable":true},"timestamp":{"type":"string","format":"date-time"},"requestId":{"type":"string","nullable":true},"data":{"nullable":true},"meta":{"$ref":"#/components/schemas/ApiV1Meta"},"rateLimit":{"$ref":"#/components/schemas/ApiV1RateLimit"}},"additionalProperties":false},"ApiV1Response2":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true for successful responses."},"apiVersion":{"type":"string","description":"Semantic API version (e.g., \"1.0.0\").","nullable":true},"timestamp":{"type":"string","description":"UTC timestamp when the response was generated.","format":"date-time"},"requestId":{"type":"string","description":"Unique request identifier for tracing.","nullable":true},"data":{"description":"The response payload.","nullable":true},"meta":{"$ref":"#/components/schemas/ApiV1Meta2"},"rateLimit":{"$ref":"#/components/schemas/ApiV1RateLimit2"}},"additionalProperties":false,"description":"Standardized successful API response wrapper for v1.0.0 endpoints."},"ApiV1RateLimit2":{"type":"object","properties":{"limit":{"type":"integer","description":"Total request quota for the current window.","format":"int32"},"remaining":{"type":"integer","description":"Remaining requests in the current window.","format":"int32"},"reset":{"type":"string","description":"UTC timestamp when the rate limit window resets.","format":"date-time"}},"additionalProperties":false,"description":"Rate limit information returned with each response."},"ApiV1Meta2":{"type":"object","properties":{"page":{"type":"integer","description":"Current page number (1-based).","format":"int32"},"pageSize":{"type":"integer","description":"Number of items per page.","format":"int32"},"totalRecords":{"type":"integer","description":"Total number of records available across all pages.","format":"int32"},"totalPages":{"type":"integer","description":"Total number of pages.","format":"int32","readOnly":true},"hasNextPage":{"type":"boolean","description":"Whether there is a next page available.","readOnly":true},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page available.","readOnly":true}},"additionalProperties":false,"description":"Pagination and metadata information for collection responses."}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey"},"ApiKeyAuthQuery":{"type":"apiKey","in":"query","name":"apikey"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"url":"https://api-sandbox.argaam.com","description":"Argaam API Gateway (Sandbox)"}]}
```