Endpoints
Base URL
https://api.proxy.gonka.gg/v1
The website origin https://proxy.gonka.gg is the app. Some /api/* routes are rewritten there for the dashboard. SDKs should still use api.proxy.gonka.gg.
Inference
| Method | Path | Auth | Description |
|---|
| GET | /health | None | Health check |
| GET | /v1/models | None | OpenAI model list |
| GET | /api/models/capabilities | None | Context, tools, reasoning, quantization |
| GET | /api/pricing | None | Live USD per token |
| GET | /api/status | None | Public health payload |
| POST | /v1/chat/completions | API key | Chat completions |
| POST | /v1/systemone | API key | Jev decisions. Not a Gonka model. Same as POST /v1/decisions. See Jev. |
| GET | /v1/systemone | None | Jev model description and eligibility rules |
Account (API key)
| Method | Path | Description |
|---|
| GET | /v1/balance | USD credit, remaining token allowance, lifetime tokens, requests, prompt/completion split, and spend for the account billed by the API key. Available even when the balance is exhausted. |
| POST | /v1/topup/gnk | Create a one-time native GNK deposit address for that same account. Body is empty. Returns payment_id, address, denom (ngonka), and gonka_usd. |
| POST | /v1/topup/wgnk | Create a one-time WGNK deposit address. Optional body { "expected_amount_wei": "..." }. Returns payment_id, address, contract, decimals, and wgnk_usd. |
| GET | /v1/topup/{payment_id} | Poll that deposit. status becomes confirmed after the transfer is credited. |
| POST | /v1/agents | Start a server-side agent. Body is { "model", "goal" }. Returns the job with status: "running". The loop keeps running after the client disconnects. At most two jobs run at once. Each model step is billed like a chat completion. |
| GET | /v1/agents | Newest jobs for this key. jobs[].answer is empty here. |
| GET | /v1/agents/{id} | One job: status (running, done, error, cancelled), steps (tool name and a short detail), and the full answer. |
| DELETE | /v1/agents/{id} | Cancel a running job. |
Account (JWT)
| Method | Path | Description |
|---|
| POST | /api/auth/register | Create account |
| POST | /api/auth/login | Sign in |
| GET | /api/auth/me | Current user |
| GET / POST / DELETE | /api/keys | Manage API keys |
| GET | /api/usage, /api/usage/summary, /api/usage/daily | Usage |
| GET | /api/jev/eligibility | This account's Jev eligibility |
| GET / PUT | /api/settings | Account settings |
MCP (API key)
| Method | Path | Description |
|---|
| GET / POST | /v1/mcp/servers | List or add saved servers |
| PATCH / DELETE | /v1/mcp/servers/{id} | Update or remove |
| GET | /v1/mcp/tools | Discover tools |
| POST | /v1/mcp/call | Call one tool |
| POST | /v1/mcp/resolve | Parse Cursor / Claude JSON |
See MCP.
Partners and OAuth
Documented on Partners and OAuth.