HooderAi logoHooderAi
Log inGet a key
Docs · five minutes

Quickstart.

Wallet, key, first request. Three steps and you are billed per token.

On this page
  1. Connect a wallet
  2. Mint a key
  3. Send a request
  4. Controls and billing
1

Connect a wallet

Open the dashboard, click Connect Wallet (MetaMask or Rabby), sign the login message. One signature opens a 7-day session.

2

Mint a key

POST /api/keys with session token
response: key hk-... (save now, hash only in DB)
3

Send a request

POST /api/v1/chat/completions
Authorization: Bearer hk-...
body: model hooder/chatgpt-terra + messages

Existing tools: set base_url to https://hooderai.site/v1 — OpenCode, Cline, Continue, Codex CLI, Claude Code, Zed.

Controls and billing

Allowlist

Pin a key to specific model ids. Anything else is rejected pre-flight.

Weekly budget

Cap tokens per key per week. Over-budget fails fast with a clear error.

Top up

USDG on Robinhood Chain from your wallet. Watcher confirms Transfer, mints credits 1:1. Min $10.

Withdraw

Request in-dashboard. Admin approves, sends manually, marks sent with the tx hash. Deduct at send-time.

Endpoints

GET  /api/v1/models             public list, OpenAI shape
POST /api/v1/chat/completions   chat, Bearer hk-...
GET  /api/stats                  public market stats
POST /api/auth/nonce verify      wallet login to session
GET  /api/keys  POST /api/keys   manage keys, session
GET  /api/usage                  balance plus history
GET  /api/payouts                withdrawals, session