# CheapTokens.ai

## What is CheapTokens?
CheapTokens.ai sells discounted AI API credits powered by Venice.ai. We offer surplus Venice.ai API capacity at time-decay dynamic pricing before it expires at midnight UTC each day.

## How it works
- Credits are purchased with USDC (on Base network) via the x402 protocol — no account or signup needed.
- Upon purchase, you receive a Venice.ai INFERENCE API key with a credit usage limit.
- You call the Venice API directly at api.venice.ai/api/v1 — CheapTokens is not a proxy.
- All keys and credits expire at midnight UTC daily. Unused credits do not roll over.
- Discounts start at ~10% early in the day and increase toward ~75% near the 23:00 UTC sales cutoff.

## Core value proposition
Discounted AI API credits. The discount increases throughout the day because the credits expire at midnight UTC. Same models, same Venice.ai infrastructure, lower price. All Venice.ai models available including Claude, GPT, Gemini, DeepSeek, Grok, Llama, and more.

## OpenAI-compatible endpoint
The API key you receive works with Venice.ai's OpenAI-compatible endpoint:
  Base URL: https://api.venice.ai/api/v1
  Auth: Bearer token (your Venice API key)
  Format: Same as OpenAI Chat Completions API

## Agent workflow
Agents and programs can use CheapTokens headlessly:
  1. GET /api/pricing — check current discount and remaining supply
  2. GET /api/supply — confirm credits are available (not sold out)
  3. POST /api/buy with { usdPaid } — pay via x402 USDC on Base
  4. Receive veniceApiKey in response — use immediately
  5. GET /api/status/{veniceKeyLast6} — monitor credit consumption
  6. Use key with any OpenAI-compatible SDK (change base_url to api.venice.ai/api/v1)

## Account recovery (agents)
No account exists — your wallet address is your identity.
  - POST /api/wallet/purchases — list purchases (requires wallet signature)
  - POST /api/wallet/reveal — reveal full API key (requires wallet signature + purchase ID)
  - POST /api/wallet/reissue — get a new key for active credits (requires wallet signature)

## Key pages
- Home: https://cheaptokens.ai/
- Buy credits: https://cheaptokens.ai/buy
- Documentation: https://cheaptokens.ai/docs
- Getting started: https://cheaptokens.ai/docs/getting-started
- OpenAI compatibility: https://cheaptokens.ai/docs/openai-compatible
- Agent skill file: https://cheaptokens.ai/docs/agent-skill
- Pricing: https://cheaptokens.ai/pricing

## API endpoints (no auth)
- GET /api/pricing — current discount, credits per dollar, supply status
- GET /api/supply — daily capacity, sold amount, remaining credits
- GET /api/inventory — inventory status (total, sold, remaining, percent)
- GET /api/status/{keyPrefix} — purchase status by key suffix (last 4-6 chars)
- GET /api/venice/pricing — live Venice.ai model pricing
- GET /api/payments/health — payment system health check

## API endpoints (x402 payment)
- POST /api/buy — purchase credits (x402 USDC payment flow)

## API endpoints (wallet-signed)
- POST /api/wallet/purchases — list wallet's purchases
- POST /api/wallet/reveal — reveal full API key for a purchase
- POST /api/wallet/reissue — reissue key for active credits