YTD Performers - NGN Market API

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,
    "is_past_year": false,
    "year_start_date": "2026-01-02",
    "total": 2,
    "data": [
      {
        "symbol": "OKOMUOIL",
        "company_name": "Okomu Oil Palm",
        "sector": "Agriculture",
        "year_start_price": 275,
        "year_start_date": "2026-01-02",
        "current_price": 400.7,
        "end_date": "2026-04-17",
        "ytd_pct": 45.71
      },
      {
        "symbol": "DANGCEM",
        "company_name": "Dangote Cement",
        "sector": "Industrial Goods",
        "year_start_price": 210,
        "year_start_date": "2026-01-02",
        "current_price": 302.5,
        "end_date": "2026-04-17",
        "ytd_pct": 44.05
      }
    ]
  },
  "meta": {
    "plan": "growth",
    "calls_used": 212,
    "calls_remaining": 499788,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

GET

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,
    "is_past_year": false,
    "year_start_date": "2026-01-02",
    "total": 2,
    "data": [
      {
        "symbol": "OKOMUOIL",
        "company_name": "Okomu Oil Palm",
        "sector": "Agriculture",
        "year_start_price": 275,
        "year_start_date": "2026-01-02",
        "current_price": 400.7,
        "end_date": "2026-04-17",
        "ytd_pct": 45.71
      },
      {
        "symbol": "DANGCEM",
        "company_name": "Dangote Cement",
        "sector": "Industrial Goods",
        "year_start_price": 210,
        "year_start_date": "2026-01-02",
        "current_price": 302.5,
        "end_date": "2026-04-17",
        "ytd_pct": 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. For example, to pull the 20 worst performers of 2025:

curl "https://api.ngnmarket.com/v1/market/ytd-performers?type=worst&year=2025&limit=20" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

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:best

Performance direction to return. Defaults to best.

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