Account Usage - NGN Market API

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": "/market/snapshot",
        "calls": 1204
      },
      {
        "endpoint": "/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"
  }
}

GET

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": "/market/snapshot",
        "calls": 1204
      },
      {
        "endpoint": "/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"
  }
}

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

​Analytics window

Authorizations

Response

Analytics window