Your account

Balance, this key, your protection settings, rate limits and volume discount, in one call.

GET/api/v1/me

Any key works, read-only included. Always JSON. It makes a good health check: if this answers, the key works, and you can see what it may do.

Request
curl "https://www.nfa.pub/api/v1/me" \  -H "X-Api-Key: rsk_..."
Response
{  "ok": true,  "balance": { "cents": 12550, "eur": 125.5, "currency": "EUR" },  "key": { "label": "shop server", "hint": "rsk_AbCd...wXyZ", "scope": "full", "createdAt": "2026-09-14T10:02:11.000Z" },  "protection": {    "paused": false,    "ipAllowlistCount": 2,    "dailyLimitCents": 50000,    "perOrderLimitCents": null,    "maxQuantity": 20,    "hourlyLimit": null,    "productRestriction": false  },  "rateLimits": [    { "name": "buy", "endpoints": ["/api/v1/cs2", "/api/v1/rust", "/api/v1/extra"], "limit": 30, "windowSeconds": 60, "per": "account" },    ...  ],  "volumeDiscount": {    "enrolled": true,    "active": true,    "discountPct": 5,    "band": { "minUnits": 200, "discountPct": 5 },    "unitsCounted": 238,    "windowDays": 30,    "nextBand": { "minUnits": 500, "discountPct": 8, "unitsToGo": 262 },    "bands": [ { "minUnits": 0, "discountPct": 0 }, { "minUnits": 50, "discountPct": 3 }, ... ]  }}

Fields

  • key.scope is full (can buy and replace) or read (can only look things up).
  • protection is what you set under API protection on your account page. Limits you have not set are null. What is left of today's budget is in /limits.
  • rateLimits lists every limit that applies, and whether it counts per IP, per key or per account.
  • volumeDiscount has details only when your account is on the volume ladder. Otherwise it is {"enrolled": false, "active": false, "discountPct": 0}.

Volume discount

  • unitsCounted is the number of accounts delivered to you in the last windowDays days.
  • band is the step that volume reaches. nextBand is the one after it, with unitsToGo.
  • discountPct is what applies right now. It is 0, and active is false, below the first step and while the discount is withheld; band still shows the step your volume reaches.
  • The exact price per product, discount included, is priceCents in /products. Some products are discounted less or not at all, and a price agreed for your account is never discounted further.
  • How the ladder works: Reseller program.

Errors

CodeHTTPMeaning
E1001401The key is missing, malformed, revoked or unknown.
E1002429Too many requests. Wait for the minute to roll over and retry. See Rate limits.
E1702403The request came from an IP that is not on your allowlist.
E1000500Something went wrong on our side. Retry, and contact support if it keeps happening.

Rate limit: 120 requests a minute per IP address.

Your account (GET /me) · API reference · nfa.pub