Your account
Balance, this key, your protection settings, rate limits and volume discount, in one call.
GET
/api/v1/meAny 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.scopeisfull(can buy and replace) orread(can only look things up).protectionis what you set under API protection on your account page. Limits you have not set arenull. What is left of today's budget is in/limits.rateLimitslists every limit that applies, and whether it counts per IP, per key or per account.volumeDiscounthas details only when your account is on the volume ladder. Otherwise it is{"enrolled": false, "active": false, "discountPct": 0}.
Volume discount
unitsCountedis the number of accounts delivered to you in the lastwindowDaysdays.bandis the step that volume reaches.nextBandis the one after it, withunitsToGo.discountPctis what applies right now. It is0, andactiveisfalse, below the first step and while the discount is withheld;bandstill shows the step your volume reaches.- The exact price per product, discount included, is
priceCentsin/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
| Code | HTTP | Meaning |
|---|---|---|
E1001 | 401 | The key is missing, malformed, revoked or unknown. |
E1002 | 429 | Too many requests. Wait for the minute to roll over and retry. See Rate limits. |
E1702 | 403 | The request came from an IP that is not on your allowlist. |
E1000 | 500 | Something went wrong on our side. Retry, and contact support if it keeps happening. |
Rate limit: 120 requests a minute per IP address.