Skip to main content
GET
/
v1
/
market
/
ytd-performers
Year-to-date stock returns
curl --request GET \
  --url https://api.ngnmarket.com/v1/market/ytd-performers \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "type": "best",
    "year": 2026,
    "isPastYear": false,
    "yearStartDate": "2026-01-02",
    "total": 2,
    "data": [
      {
        "symbol": "OKOMUOIL",
        "companyName": "Okomu Oil Palm",
        "sector": "Agriculture",
        "yearStartPrice": 275,
        "yearStartDate": "2026-01-02",
        "currentPrice": 400.7,
        "endDate": "2026-04-17",
        "ytdPct": 45.71
      },
      {
        "symbol": "DANGCEM",
        "companyName": "Dangote Cement",
        "sector": "Industrial Goods",
        "yearStartPrice": 210,
        "yearStartDate": "2026-01-02",
        "currentPrice": 302.5,
        "endDate": "2026-04-17",
        "ytdPct": 44.05
      }
    ]
  },
  "meta": {
    "plan": "growth",
    "calls_used": 212,
    "calls_remaining": 499788,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}
The YTD performers endpoint ranks NGX-listed stocks by their year-to-date return, calculated from the first available trading day of the year through to the most recent session. You can request the best performers, the worst performers, or both together. Each entry includes the year-start price and date, the current closing price, and the total percentage return for the year so far. Historical years are also supported via the year parameter, making this endpoint useful for annual reviews as well as live tracking.

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Query Parameters

​
type
enum<string>
default:worst

Performance direction to return. Defaults to worst.

Available options:
best,
worst
​
limit
integer
default:10

Number of stocks to return. Maximum 30.

Required range: 1 <= x <= 30
​
year
integer

Calendar year to evaluate (e.g. 2025). Defaults to the current year. Provide a past year to query historical annual performance.

Example:

2026

Response

YTD performers retrieved successfully.

​
success
boolean
required
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object