REST Endpoints

Full reference for the Bithaven REST API. All endpoints are prefixed with /api/v1.

Auth

/api/v1/auth

Auth: None (public)

Method	Path	Description
POST	`/signup`	Create account. Returns user + JWT.
POST	`/login`	Authenticate. Returns user + JWT.
POST	`/logout`	Invalidate JWT session.
GET	`/me`	Get current user.

/api/v1/wallet

Auth: JWT

Method	Path	Description
GET	`/`	Get master wallet (address, balance).
GET	`/balance`	Get balance only.
GET	`/deposits`	Paginated deposit history. Query: page, limit.

/api/v1/agent-wallets

Auth: JWT

Method	Path	Description
POST	`/`	Create agent wallet. Body: { "label": "My Agent" }
GET	`/`	List all agent wallets for user.
GET	`/:id`	Get single agent wallet.
PATCH	`/:id`	Update label. Body: { "label": "New Name" }
POST	`/:id/fund`	Transfer from master. Body: { "amount": "50.00" }
POST	`/:id/withdraw`	Transfer to master. Body: { "amount": "25.00" }
POST	`/:id/freeze`	Freeze wallet. Blocks all agent transactions.
POST	`/:id/unfreeze`	Unfreeze wallet.

/api/v1/agent-wallets/:walletId/keys

Auth: JWT

Method	Path	Description
POST	`/`	Create API key. Body: { "label": "prod-key", "scopes": ["read","write"] }
GET	`/`	List keys for wallet (prefix + metadata only).
POST	`/:keyId/revoke`	Revoke a key immediately.

/api/v1/agent-wallets/:walletId/policies

Auth: JWT

Method	Path	Description
POST	`/`	Create policy. Body: { "type": "spend_cap_daily", "params": { "limit": "50.00" } }
GET	`/`	List policies for wallet.
PATCH	`/policies/:id`	Update policy params or active status.
DELETE	`/policies/:id`	Delete policy.

/api/v1/agent-wallets/:walletId/transactions

Auth: JWT

Method	Path	Description
GET	`/`	List transactions for wallet.
GET	`/pending`	List transactions awaiting approval.
POST	`/transactions/:id/approve`	Approve a pending transaction.
POST	`/transactions/:id/reject`	Reject. Body: { "reason": "..." }

/api/v1/notifications

Auth: JWT

Method	Path	Description
GET	`/preferences`	Get notification preferences.
PATCH	`/preferences`	Update notification preferences.

/api/v1/dashboard

Auth: JWT

Method	Path	Description
GET	`/stats`	Overview stats (total balance, agents, pending txs).
GET	`/activity`	Unified activity feed. Query: page, limit, type.

/api/v1/waitlist

Auth: None

Method	Path	Description
POST	`/`	Join waitlist. Body: { "email": "..." }