For AI agents: step-by-step setup guide — /docs/agents.md, documentation index — /llms.txt.
Pricing and account
Model prices, deposit and withdrawal fees, GNK rate. Account API by key: balance, spend by day and model, transaction history, and top-ups.
Model prices#
Prices already include the platform markup 10%. Live values are at GET /api/pricing, no key required.
model | Input, $ per 1M tokens | Output, $ per 1M tokens | nGNK per token: input / output |
|---|---|---|---|
MiniMaxAI/MiniMax-M2.7 | $0.008349 | $0.02505 | 33 / 99 |
deepseek-ai/DeepSeek-V4-Flash-0731 | $0.008349 | $0.02505 | 33 / 99 |
zai-org/GLM-5.3-Flash | $0.008349 | $0.02505 | 33 / 99 |
- Request cost = input tokens × input price + output tokens × output price. Model reasoning counts as output tokens.
- Charges are in GNK (1 GNK = 10⁹
nGNK); dollar prices use the GNK rate $0.253. - Before the request, the gateway checks the balance against the cost estimate; if it's insufficient —
402 insufficient_funds. - After registration, 0.1 GNK is credited to your account — around 3M tokens at the input price.
Fees#
| Operation | Fee | Note |
|---|---|---|
| Markup on model requests | 10% | Already included in the prices above. |
| GNK top-up | free | Transfer to the gateway address with your memo; credited automatically. |
| USDT top-up | 5% → 2.5% | Payment via OxaPay; the larger the amount, the lower the fee — USDT fee tiers. |
| WGNK top-up from Ethereum | 1% | Covers the Ethereum network gas when transferring to Gonka. |
| GNK withdrawal | 5% | Dashboard only, from 1 GNK. |
| GNK rate | $0.253 | Used to calculate top-ups and dollar prices; updates automatically. |
USDT fee tiers#
The rate depends on the top-up amount, threshold inclusive:
| Top-up amount | Fee |
|---|---|
| from $0 | 5% |
| from $25 | 4.5% |
| from $50 | 4% |
| from $100 | 3.5% |
| from $250 | 3% |
| from $500 | 2.75% |
| from $1000 | 2.5% |
Account API#
Balance, spending, and top-ups are available with the same key as model requests (Authorization: Bearer jg-…). These requests don't consume tokens.
Errors: no key — 401 authentication_error, invalid parameters — 400 validation_error, dashboard route with an API key — 403 forbidden.
GET /api/balance#
Current balance.
| Field | Description |
|---|---|
balance_ngonka | Balance in nGNK — as a string to preserve precision |
balance_usd | Balance in dollars at the current rate |
cost_per_token_ngonka | Input token price of the recommended model with markup, nGNK |
tokens_remaining | How many input tokens the balance will cover at this price — an estimate |
curl -s https://gate.joingonka.ai/api/balance \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage#
Usage by day: requests, tokens, cost.
period—day,week,month,quarter; defaults tomonth.- Or
fromandtoinYYYY-MM-DD, both at once, up to 92 days inclusive — then the response includesperiod: custom. tz— offset in minutes, likegetTimezoneOffset()in the browser: for UTC+3 it's-180. Without it — UTC.
The response is an array of days with fields date, requests, tokens, costNgonka. Detailed request records are kept for 90 days.
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage/by-model#
Usage by model: totals in models and a "period × model" series in series — hours when period=day, otherwise days. Parameters are the same as for /api/usage.
GET /api/usage/by-key#
Usage by key — keys. Parameters are the same as for /api/usage.
GET /api/transactions#
Transaction history: top-ups, charges for requests, bonuses, withdrawals.
limit— up to 200, defaults to 50;offset— offset.type— filter:DEPOSIT_USDT,DEPOSIT_GNK,DEPOSIT_FIAT,INFERENCE,REFERRAL_REWARD,BONUS,WITHDRAWAL.fromandto— dates, end inclusive.
The response contains records with fields id, type, amountNgonka, feeNgonka, description, createdAt and the total count total. INFERENCE records older than 90 days are collapsed into one per day.
GET /api/deposits#
Top-ups only. Parameters limit, offset, from, and to are the same as for transaction history; the response includes total.
POST /api/deposit/gnk#
GNK top-up details: address and memo. Send GNK to this address with this memo — the credit is automatic.
GET /api/deposit/usdt/rate#
USDT top-up rate and fee: gnk_usd_price, fee_percent, fee_tiers.
POST /api/deposit/usdt#
USDT invoice: the body {"amount": 25} — the amount in dollars from 1 to 10000; the response contains payment_url. If USDT deposits are temporarily closed — 503.
GET /api/pricing#
Prices and fees without a key: models[], deposit_usdt_fee_tiers, the GNK rate, and the sign-up bonus.
Dashboard only#
Account management lives in the dashboard gate.joingonka.ai/dashboard. These routes aren't meant for integrations; some of them respond to the API key with 403 forbidden:
- API keys — gate.joingonka.ai/keys;
- GNK withdrawal — from 1 GNK;
- card top-ups and WGNK sender addresses;
- promo codes;
- the referral program and mailing settings.