Colorful Moves

API Reference

Complete endpoint documentation for api.colorfulmoves.com · Version 4.0.0

Public Endpoints No auth required

GET /api/health System health & bindings status
{ "status": "healthy",
"version": "4.0.0",
"ai_binding": true,
"d1_binding": true,
"kv_binding": true }
GET /api API info, pricing, public endpoints
GET /api/models Available AI models & agents
GET /api/pricing Tier details: Free, Pro, Enterprise
POST /api/signup Create free API key instantly
BodyTypeDescription
emailstringRequired. Valid email address.
namestringOptional. Display name.
curl -X POST "https://api.colorfulmoves.com/api/signup" \
-H "Content-Type: application/json" \
-d '{"email":"you@company.com","name":"Dev"}'

Authentication

All authenticated endpoints require an API key. Pass it via X-API-Key header or ?key= query parameter.

GET /api/key Get your key info & tier
curl "https://api.colorfulmoves.com/api/key" \
-H "X-API-Key: cm_xxxxxxxxxxxxxxxx"

Chat Endpoints

POST /api/agent/chat Single agent chat with any of 11 agents
BodyTypeDescription
agentstringRequired. Agent ID: nomatica, lupus, sage, etc.
messagestringRequired. User prompt.
systemPromptstringOptional. Override default system prompt.
POST /api/agent/chat-multi Parallel multi-agent query
curl -X POST "https://api.colorfulmoves.com/api/agent/chat-multi" \
-H "X-API-Key: cm_xxx" \
-H "Content-Type: application/json" \
-d '{"agents":["lupus","sage","trader"],"message":"Analyze risks"}'
POST /api/agent/chat/stream SSE streaming response (~20 words/sec)
POST /api/chat Direct model access (custom messages)

Billing

GET /api/billing Current tier, limits, subscription status
GET /api/usage Usage stats: daily/monthly, per-agent breakdown
POST /api/portal Stripe Customer Portal (manage/cancel/update card)

Payment Endpoints

POST /api/checkout Stripe Checkout session for subscriptions
POST /api/checkout/square Square backup checkout (alternative provider)
POST /api/topup Emergency request packs: 100/500/1000
POST /api/webhooks/stripe Stripe webhook receiver (HMAC verified)

Admin Dashboards Admin key required

GET /api/admin/revenue?admin_key=xxx Revenue: MRR, subscribers, churn, usage
GET /api/admin/pnl?admin_key=xxx PnL: margins, costs, conversion funnel

Analytics

POST /api/analytics Track landing page events (public)

Available Models

ModelNameTierSpecialty
@cf/meta/llama-3-70b-instructLlama 3 70BPremiumComplex reasoning, finance, trading
@cf/meta/llama-3-8b-instructLlama 3 8BStandardFast responses, general queries
@cf/meta/llama-3.1-8b-instructLlama 3.1 8BStandardGeneral purpose
@cf/google/gemma-2-7b-itGemma 2 7BStandardTechnical, security (Lupus)
@cf/qwen/qwen2-7b-instructQwen 2 7BStandardMultilingual, DevOps (Orion)
@cf/deepseek-ai/deepseek-coder-33b-instructDeepSeek CoderPremiumCode generation, blockchain (Dai, Coder)
@cf/tii/falcon-3-7b-instructFalcon 3 7BStandardCreative, general (Cosmos)
@cf/mistral/mistral-7b-instruct-v0.2Mistral 7BStandardGeneral purpose

Tier Pricing

FeatureFreePro ($29/mo)Enterprise ($299/mo)
Daily requests10010,000Unlimited
Monthly requests3,000300,000Unlimited
ModelsStandard (8B)All (70B + 33B)All + Custom
Agents101010 + Custom
Multi-agentMax 3UnlimitedUnlimited
SupportCommunityEmailDedicated + SLA