> For AI agents: step-by-step setup guide — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), documentation index — [`/llms.txt`](https://gate.joingonka.ai/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](https://gate.joingonka.ai/docs/billing#usdt-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 |

```bash
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 to `month`.
- Or `from` and `to` in `YYYY-MM-DD`, both at once, up to 92 days inclusive — then the response includes `period: custom`.
- `tz` — offset in minutes, like `getTimezoneOffset()` 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.

```bash
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`.
- `from` and `to` — 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](https://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](https://gate.joingonka.ai/keys);
- GNK withdrawal — from 1 GNK;
- card top-ups and WGNK sender addresses;
- promo codes;
- the referral program and mailing settings.