Market Data API

Company Profiles and Market Intelligence

MyStocks Partner API

Build search, company detail, news, corporate-action, and curated market-intelligence experiences with MyStocks data.

Integration guides Get a sandbox key

Explore endpoints

6 of 6

GET

/companies

List companies

Full endpoint documentation

Sandbox availablelistCompanies

Returns company profiles with fundamental data (description, sector, country, financials). Supports exchange and sector filtering.

Parameters

exchangestringquery

Example: JSE

sectorstringquery

cursorstringquery

Opaque cursor returned by the previous page.

limitintegerquery

Example: 50

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

companiesobject[]

companies[].symbolstring

companies[].namestring

companies[].exchangestring

companies[].sectorstring | null

companies[].countrystring

companies[].descriptionstring | null

companies[].logoUrlstring | null

countinteger

hasMoreboolean

nextCursorstring | null

Response codes

200Company list.

Sandbox playground

Read-only sandbox request

exchange Optional · querysector Optional · querycursor Optional · querylimit Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/companies

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "companies": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "exchange": {
            "type": "string"
          },
          "sector": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "logoUrl": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "count": {
      "type": "integer"
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}

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

Company discovery

GET /companies lists company profiles with exchange and sector filters.
GET /companies/tickers returns canonical symbols, slugs, names, and exchanges.
GET /companies/{symbol} returns profile and fundamentals.
GET /companies/{symbol}/news returns curated company news and announcements.
GET /market-intel and GET /market-intel/{id} provide curated market intelligence.

Use the canonical SYMBOL.EXCHANGE identifier from the ticker catalogue. Do not resolve symbols by company name alone when multiple exchanges list the same issuer.

Company intelligence is curated editorial and corporate-action content, not a guaranteed high-volume newswire. Display source, publication time, and any exchange attribution returned by the API. See Data Licensing before redistribution.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Send note

Last updated on

Charts and OHLCV

Market Data API FAQs