Skip to main content
GET
/
v1
/
account
/
usage
Quota status and 30-day analytics
curl --request GET \
  --url https://api.ngnmarket.com/v1/account/usage \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "period": "2026-04",
    "calls_used": 4821,
    "calls_limit": 100000,
    "calls_remaining": 95179,
    "reset_at": "2026-05-01T00:00:00.000Z",
    "daily": [
      {
        "date": "2026-04-16",
        "calls": 312
      },
      {
        "date": "2026-04-17",
        "calls": 489
      }
    ],
    "top_endpoints": [
      {
        "endpoint": "/v1/market/snapshot",
        "calls": 1204
      },
      {
        "endpoint": "/v1/companies",
        "calls": 987
      }
    ],
    "status_breakdown": {
      "2xx": 4710,
      "4xx": 98,
      "5xx": 13,
      "total": 4821
    }
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4821,
    "calls_remaining": 95179,
    "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.

Returns your current quota status and a 30-day analytics summary scoped to the authenticated user. All data is read from api_request_logs, so it reflects only authenticated requests. Calls that failed auth or were blocked before reaching a route are not counted. This endpoint is available on all plans including Free. It does not consume a quota call.

​
Analytics window

All analytics fields (daily, top_endpoints, status_breakdown) cover the last 30 calendar days from the current date. The quota fields (calls_used, calls_limit, calls_remaining) reflect the current billing month, which resets on the 1st.

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.

Response

Usage data retrieved successfully.

​
success
boolean
required
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object