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

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.

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
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object