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"
  }
}

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