# JarvisClaw AI API

> AI model routing platform. 40+ models (GPT, Claude, Gemini, DeepSeek, etc).
> Pay per call with USDC via x402 protocol. No account needed. OpenAI-compatible.

## AI Models
- Chat Completions: POST https://api.jarvisclaw.ai/v1/chat/completions (OpenAI-compatible, streaming, function calling, vision)
- Responses API: POST https://api.jarvisclaw.ai/v1/responses (OpenAI Responses format)
- Image Generation: POST https://api.jarvisclaw.ai/v1/images/generations (DALL-E, GPT-Image, CogView, Grok Imagine)
- Image Editing: POST https://api.jarvisclaw.ai/v1/images/edits
- Video Generation: POST https://api.jarvisclaw.ai/v1/videos/generations (Sora, Seedance, Grok Video)
- Audio / TTS: POST https://api.jarvisclaw.ai/v1/audio/speech
- Audio Transcription: POST https://api.jarvisclaw.ai/v1/audio/transcriptions
- Music Generation: POST https://api.jarvisclaw.ai/v1/audio/generations
- Embeddings: POST https://api.jarvisclaw.ai/v1/embeddings
- Reranking: POST https://api.jarvisclaw.ai/v1/rerank
- Moderations: POST https://api.jarvisclaw.ai/v1/moderations
- Web Search: POST https://api.jarvisclaw.ai/v1/search
- Realtime (WebSocket): GET https://api.jarvisclaw.ai/v1/realtime
- Model List: GET https://api.jarvisclaw.ai/v1/models

## Marketplace Services
- Prediction Markets: https://api.jarvisclaw.ai/v1/marketplace/prediction/* or https://api.jarvisclaw.ai/v1/prediction/* (Polymarket, Kalshi, Sports — 58 endpoints)
- Crypto Data (Surf): https://api.jarvisclaw.ai/v1/marketplace/surf/* (83 endpoints — exchange, social, wallet, token, fund, onchain, news)
- DEX Trading (0x): https://api.jarvisclaw.ai/v1/marketplace/dex/* (swap routing, best-price execution)
- Web Search (Exa): https://api.jarvisclaw.ai/v1/marketplace/exa/* (neural search + content retrieval)
- Compute Sandbox: https://api.jarvisclaw.ai/v1/marketplace/compute/* (isolated code execution via Modal)
- Phone & Voice: https://api.jarvisclaw.ai/v1/marketplace/phone/* (AI voice calls + phone numbers)
- Market Data: https://api.jarvisclaw.ai/v1/marketplace/data/* (stocks, crypto, FX, commodities)
- DeFi (DefiLlama): https://api.jarvisclaw.ai/v1/marketplace/defi/* (TVL, protocol metrics, yields)
- Trading Markets: https://api.jarvisclaw.ai/v1/marketplace/markets/* (real-time trading data)
- RealFace Portrait: https://api.jarvisclaw.ai/v1/marketplace/realface/* (AI portrait generation)
- Portrait: https://api.jarvisclaw.ai/v1/marketplace/portrait/* (AI portrait styles)
- AI Creation: https://api.jarvisclaw.ai/v1/marketplace/creation/* (image generation + editing)
- Video Generation: https://api.jarvisclaw.ai/v1/marketplace/video/* (AI video from text/image)
- Blockchain RPC: https://api.jarvisclaw.ai/v1/marketplace/rpc/* (40+ chains — ETH, SOL, Base, Polygon, etc.)

## User-Published APIs (UAPI Marketplace)
- Browse APIs: GET https://api.jarvisclaw.ai/api/user-api/list
- Use any published API: https://api.jarvisclaw.ai/v1/uapi/{slug}/* (independent pricing per API)

## Midjourney
- Submit tasks: POST https://api.jarvisclaw.ai/mj/submit/imagine, https://api.jarvisclaw.ai/mj/submit/change, https://api.jarvisclaw.ai/mj/submit/blend, etc.
- Check status: GET https://api.jarvisclaw.ai/mj/task/{id}/fetch
- Face swap: POST https://api.jarvisclaw.ai/mj/insight-face/swap

## Agent Registry
- Search agents: GET https://api.jarvisclaw.ai/api/agents
- Register your agent: POST https://api.jarvisclaw.ai/api/agents/register
- Heartbeat: POST https://api.jarvisclaw.ai/api/agents/heartbeat

## Authentication (choose one)
- x402 Payment: Send PAYMENT-SIGNATURE header with USDC payment proof. No account required.
- API Key: Authorization: Bearer sk-...

## Payment Networks
- Base (EVM): USDC on Base mainnet (CAIP-2: eip155:8453)
- Solana: USDC on Solana mainnet (CAIP-2: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)

## Pricing (machine-readable)
- All models with per-token USD pricing: GET https://api.jarvisclaw.ai/api/discovery/models
- Free and cheap models for testing: GET https://api.jarvisclaw.ai/api/discovery/free-models
- Platform health and capabilities: GET https://api.jarvisclaw.ai/api/discovery/health

## SDKs
- Python (LangChain): pip install langchain-jarvisclaw
- Python (CrewAI): pip install crewai-jarvisclaw
- Python (AutoGen): pip install autogen-jarvisclaw
- Python (native): pip install jarvisclaw
- Go: go get github.com/api-jarvisclaw/go-sdk

## Discovery
- x402 Discovery: GET https://api.jarvisclaw.ai/.well-known/x402/discovery
- Agent Manifest: GET https://api.jarvisclaw.ai/agent-manifest.json
- OpenAPI Spec: GET https://api.jarvisclaw.ai/api/openapi.json
- MCP Server: POST https://api.jarvisclaw.ai/mcp (JSON-RPC 2.0, tools/list to enumerate)
- Agent Registry: GET https://api.jarvisclaw.ai/api/agents

## Documentation
- Docs: https://docs.jarvisclaw.ai
- Quickstart: https://docs.jarvisclaw.ai/quickstart
- SDK Reference: https://docs.jarvisclaw.ai/sdk
- Framework Integrations: https://docs.jarvisclaw.ai/frameworks

## Agent Economy
- Intent Resolution: POST /v1/intent/resolve — declare intent + constraints, get optimal provider (FREE)
- One-shot Execute: POST /v1/intent/execute — resolve + execute in single request
- Wallet Management: GET /v1/wallet/balance — autonomous treasury for agents
- Full loop: discover → budget check → execute → settle
- 40+ AI providers with real-time cost/quality/latency scoring
- Supports x402 micropayments (zero registration) and API key auth