Search
K
News & Editorial Layer API (Sandbox)

Get the corporate event calendar for a market.

Returns upcoming and recently completed corporate events for all
companies in the specified market, including:

  • Annual / Extraordinary General Meetings (AGM / EGM)
  • Dividend announcements and payment dates
  • Earnings releases and financial results
  • Investor-day and conference dates

Events are returned in reverse-chronological order (newest first).

Tip: For a single company’s events use
GET /companies/{companyId}/events.

get
https://api-sandbox.argaam.com/api/v1.1/markets/{marketId}/events

Path Parameters

marketIdinteger(int32)required

Market ID (e.g. 1 for Saudi Tadawul).

Example:3

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/markets/{marketId}/events
 
200 application/json

List articles published in a date range, paged.

Returns the firehose of Argaam articles for the requested time
window. Use this endpoint for chronological feeds such as a
news sidebar or mobile timeline.

Example

GET /api/v1.1/news/articles?from=2024-01-01&to=2024-01-31&lang=en&page=1&pageSize=50

Tips

  • Both dates accept ISO-8601 (2024-01-31) or any
    M:System.DateTime.Parse(System.String)-compatible format.
  • Defaults: from = yesterday, to = now, lang = ar,
    pageSize = 200 (max).
get
https://api-sandbox.argaam.com/api/v1.1/news/articles

Query Parameters

fromstring

Start timestamp (inclusive). Defaults to yesterday.

Example:2024-01-01

tostring

End timestamp (inclusive). Defaults to now.

Example:2024-03-31

langstring

Article language. Allowed: ar, en. Default: ar. Defaults to ar.

Default:ar

Example:1

pageinteger(int32)

1-based page number. Default: 1. Defaults to 1.

Default:1

Example:1

pageSizeinteger(int32)

Records per page. Max: 200. Default: 200. Defaults to 200.

Default:200

Example:20

Response

200 application/json

Success

* Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
languagestring | nullread-only
titlestring | null
publishedOnstring | null
linkstring | nullread-only
isLinkedboolean
linkedToURLstring | null
isPaidboolean
articleSourceNamestring | null
sourcestring | null
articleTypestring | nullread-only
articleTypeNameArstring | null
articleTypeNameEnstring | null
marketTickerIDsstring | null
marketTickerChartIDsarray | null[string]read-only
companyTickerIDsstring | null
companyTickerChartIDsarray | null[string]read-only
bodystring | null
showDetailsboolean
iconURLstring | null
get/api/v1.1/news/articles
 
200 application/json

List popular articles

Returns the popular articles available on this layer.

Set lang to 1 for English or 2 for Arabic.

get
https://api-sandbox.argaam.com/api/v1.1/news/articles/popular

Query Parameters

marketIdinteger(int32)

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

Default:3

Example:3

langstring

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

Default:ar

Example:1

Response

200 application/json

Success

* Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
languagestring | nullread-only
titlestring | null
linkstring | nullread-only
isLinkedboolean
linkedToURLstring | null
get/api/v1.1/news/articles/popular
 
200 application/json

Get the market pulse feed

Returns the curated short-form market pulse feed: the headline items Argaam’s editorial desk considers market-moving right now, newest first.

Paginated: use page and pageSize. Bound the result with the from and to date parameters. Set lang to 1 for English or 2 for Arabic.

get
https://api-sandbox.argaam.com/api/v1.1/news/market-pulse

Query Parameters

marketIdinteger(int32)

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

Default:3

Example:3

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

langstring

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

Default:ar

Example:1

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 application/json

Success

* Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
titlestring | null
bodystring | null
sourcestring | null
isLinkedboolean
linkedToURLstring | null
isLockedboolean
displayTimestring(date-time)
get/api/v1.1/news/market-pulse
 
200 application/json

Get a article by articleId

Returns the article identified by articleId.

Set lang to 1 for English or 2 for Arabic.

get
https://api-sandbox.argaam.com/api/v1.1/news/articles/{articleId}

Query Parameters

langstring

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

Default:ar

Example:1

styledboolean

When true, returns values pre-formatted for display (thousands separators, currency suffixes) instead of raw numbers. Defaults to True.

Default:true

Example:true

Path Parameters

articleIdinteger(int32)required

Identifier of the news article.

Response

200 application/json

Success

ArticleDetails

* Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
languagestring | nullread-only
titlestring | null
bodystring | null
shortURLstring | null
publishedOnstring | null
articleSourceNamestring | null
articleTypestring | nullread-only
articleTypeNameArstring | null
articleTypeNameEnstring | null
marketTickerIDsstring | null
marketTickerChartIDsarray | null[string]read-only
companyTickerIDsstring | null
companyTickerChartIDsarray | null[string]read-only
customAMPCssstring | null
get/api/v1.1/news/articles/{articleId}
 
200 application/json