Buyer Endpoints

All require authentication (API key or session cookie).

Keys

POST/v1/buyer/keys

Create a new key (up to 25 per wallet).

GET/v1/buyer/keys

List all keys (prefix, label, timestamps, revoked status).

DELETE/v1/buyer/keys/{id}

Revoke a key.

Keys

bash

POST /v1/buyer/keys
{ "label": "Cursor" }

bash

GET /v1/buyer/keys

bash

DELETE /v1/buyer/keys/{id}

Profile

GET/v1/buyer/me

Balance, allowance, usage stats, per-model breakdown.

GET/v1/buyer/savings

Savings vs direct provider pricing (all-time). Add ?period=daily or ?period=weekly for savings bucketed by day or week.

GET/v1/buyer/approve-status

USDC approval status for SettlementV2/API-key usage.

Profile

bash

GET /v1/buyer/me

bash

GET /v1/buyer/savings

bash

GET /v1/buyer/savings?period=daily
GET /v1/buyer/savings?period=weekly

bash

GET /v1/buyer/approve-status

Usage Export

GET/v1/buyer/usage/export

CSV export of all usage records.

Columns: timestamp, model, input_tokens, output_tokens, cost_usd, settlement_status, tx_hash. Up to 50,000 rows.

Usage export

bash

GET /v1/buyer/usage/export?format=csv&from=2026-01-01&to=2026-04-13

Providers (BYOK)

Register your own provider keys as buyer-owned providers. A provider scoped to a specific model is tried first for that model (priority — the marketplace is overflow only). A provider with model: null is a catch-all fallback used for any model when all marketplace sellers fail.

POST/v1/buyer/providers

GET/v1/buyer/providers

List providers.

DELETE/v1/buyer/providers/{id}

Remove a provider.

Routing order: model-scoped priority provider → marketplace sellers → catch-all (model: null) provider → universal fallback.

Providers (BYOK)

bash

POST /v1/buyer/providers
{ "model": "claude-opus-4.6", "api_key": "sk-...", "base_url": "https://api.venice.ai/api/v1" }

bash

POST /v1/buyer/providers
{ "model": null, "api_key": "sk-...", "base_url": "https://api.venice.ai/api/v1" }

bash

GET /v1/buyer/providers

bash

DELETE /v1/buyer/providers/{id}