API product catalogPan-African Market Data & Intelligence

Company news & corporate actions

Pan-African Market Data & Intelligence

GET

/companies/{symbol}/news

Sandbox availablelistNews

Returns a merged, reverse-chronological feed for a single company: MyStocks' curated market-intelligence items (source: MARKET_NEWS) plus corporate actions such as dividends, splits, and rights issues (source: CORPORATE_ACTION). This is the same curated editorial content shown in the MyStocks consumer app — not a high-volume third-party newswire. Filter to one kind with ?type=NEWS.

Parameters

symbolstringpathRequired

Example: SCOM.KE

typestringquery

Optional filter by item type, e.g. NEWS or a corporate-action type (DIVIDEND, SPLIT, ...).

Example: NEWS

limitintegerquery

Example: 50

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

symbolstring

Example: "SCOM.KE"

namestring

Example: "Safaricom PLC"

countinteger

Example: 5

itemsobject[]

items[].idstring

items[].sourceMARKET_NEWS | CORPORATE_ACTION

items[].typestring

NEWS for market intel; the action type (e.g. DIVIDEND) for corporate actions.

Example: "NEWS"

items[].titlestring

items[].descriptionstring

items[].urlstring

items[].exDatestring

Ex-date (corporate actions only).

items[].payDatestring

Pay-date (corporate actions only).

items[].amountnumber

Distribution amount (corporate actions only).

items[].currencystring

items[].createdAtstring

Response codes

200Merged company news and corporate-action feed.

Sandbox playground

Read-only sandbox request

symbol Required · pathtype Optional · querylimit Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/companies/%7Bsymbol%7D/news

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "example": "SCOM.KE"
    },
    "name": {
      "type": "string",
      "example": "Safaricom PLC"
    },
    "count": {
      "type": "integer",
      "example": 5
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "enum": [
              "MARKET_NEWS",
              "CORPORATE_ACTION"
            ]
          },
          "type": {
            "type": "string",
            "description": "NEWS for market intel; the action type (e.g. DIVIDEND) for corporate actions.",
            "example": "NEWS"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "exDate": {
            "type": "string",
            "nullable": true,
            "description": "Ex-date (corporate actions only)."
          },
          "payDate": {
            "type": "string",
            "nullable": true,
            "description": "Pay-date (corporate actions only)."
          },
          "amount": {
            "type": "number",
            "nullable": true,
            "description": "Distribution amount (corporate actions only)."
          },
          "currency": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      }
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/companies/%7Bsymbol%7D/news' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

GET /companies/{symbol}/chart

GET /companies/tickers