Skip to main content
GET
Year-to-date stock returns

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