Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

The YTD performers endpoint ranks every NGX stock by its return from the first trading day of the year to today. This example fetches the top 10 gainers and top 10 losers for the current year. Endpoint: GET /v1/market/ytd-performers (Growth plan)

​
Fetch the top 10 YTD gainers

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

​
Sample response (trimmed)

{
  "success": true,
  "data": {
    "type": "best",
    "year": 2026,
    "is_past_year": false,
    "year_start_date": "2026-01-02",
    "total": 10,
    "data": [
      {
        "symbol": "OKOMUOIL",
        "company_name": "Okomu Oil Palm",
        "sector": "Agriculture",
        "year_start_price": 290.00,
        "year_start_date": "2026-01-02",
        "current_price": 400.70,
        "end_date": "2026-04-17",
        "ytd_pct": 38.17
      },
      {
        "symbol": "GTCO",
        "company_name": "Guaranty Trust Holding Co.",
        "sector": "Banking",
        "year_start_price": 41.20,
        "year_start_date": "2026-01-02",
        "current_price": 53.05,
        "end_date": "2026-04-17",
        "ytd_pct": 28.76
      }
    ]
  }
}

​
Fetch the top 10 YTD losers

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

​
Look up a historical year

Pass year to get YTD performance for a past year. The end_date in the response will reflect the last available trading day of that year:
curl
curl "https://api.ngnmarket.com/v1/market/ytd-performers?type=best&year=2025&limit=10" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

YTD performers reference

Full parameter list for GET /v1/market/ytd-performers