Marketplace Endpoints Overview
All marketplace services available through JarvisClaw. Every request settles via x402 on-chain (USDC on Base or Solana).
Domain: https://api.jarvisclaw.ai
Authentication
All endpoints accept either method:
| Method | Header | Description |
|---|---|---|
| API Key | Authorization: Bearer sk-... | Platform signs x402 from your HD wallet automatically |
| Private Key (x402) | Automatic via SDK | Agent signs x402 directly from its own wallet |
See Agent Payments (x402) for details.
Service Directory
Prices below are reference rates. Read price.amount in each response for the exact charge.
| # | Service | Base Path | Endpoints | Pricing | Docs |
|---|---|---|---|---|---|
| 1 | Prediction Markets | /v1/marketplace/prediction | 53 | $0.001–$0.0095/call | prediction-markets |
| 2 | Crypto Data (Surf) | /v1/marketplace/surf | 83 | $0.0095/call (flat) | crypto-data |
| 3 | Trading Markets | /v1/marketplace/markets | 12+ | $0.001/call (flat) | trading-markets |
| 4 | DEX Trading (0x) | /v1/marketplace/dex | 9 | $0.001/call | dex-trading |
| 5 | Web Search (Exa) | /v1/marketplace/exa | 4 | $0.004–$0.012/call | web-search |
| 6 | Image Generation | /v1/images/generations | 2 | $0.015–$0.105/image | image-generation |
| 7 | Video Generation | /v1/videos/generations | 2 | $0.05–$0.315/sec | video-generation |
| 8 | Music Generation | /v1/audio/generations | 1 | $0.1575/track | music-generation |
| 9 | Audio (TTS/STT) | /v1/audio/* | 4 | $0.05–$0.12/1k chars | audio |
| 10 | Phone Numbers | /v1/marketplace/phone | 7 | $0.003–$5.002/call | phone-voice |
| 11 | Voice Calls | /v1/marketplace/voice | 3 | $0.001–$0.542/call | phone-voice |
| 12 | Compute (Modal) | /v1/marketplace/compute | 4 | $0.001–$0.012/op | compute |
| 13 | RealFace / Portrait | /v1/marketplace/realface | 4 | $0.005–$0.01/session | realface |
| 14 | DeFi (DeFiLlama) | /v1/marketplace/defi | 5+ | $0.005/call | — |
| 15 | Blockchain RPC | /v1/marketplace/rpc | multi-chain | $0.002/call | — |
DEX trading is not free
The 0x swap endpoints publish $0 at service level but charge the service cost — measured at $0.0011 per call. Gas is separate and paid by you on-chain.
Quick Reference by Category
Financial Data & Trading
GET /v1/marketplace/markets/stocks/quote?symbol=AAPL
GET /v1/marketplace/markets/crypto/price?pair=BTC/USDT
GET /v1/marketplace/markets/forex/rate?pair=EUR/USD
POST /v1/marketplace/dex/swap/permit2/quote
POST /v1/marketplace/dex/swap/permit2/execute
GET /v1/marketplace/defi/protocolsPrediction Markets
GET /v1/marketplace/prediction/markets?status=open
GET /v1/marketplace/prediction/markets/:id
GET /v1/marketplace/prediction/sports/events
GET /v1/marketplace/prediction/sports/markets
GET /v1/marketplace/prediction/leaderboardCrypto Intelligence (Surf — 83 endpoints)
GET /v1/marketplace/surf/exchanges/list
GET /v1/marketplace/surf/market/overview
GET /v1/marketplace/surf/onchain/sql
GET /v1/marketplace/surf/wallet/labels
GET /v1/marketplace/surf/social/trending
GET /v1/marketplace/surf/defi/protocolsAI Generation
POST /v1/images/generations
POST /v1/images/edits
POST /v1/videos/generations
GET /v1/videos/generations/:id
POST /v1/audio/generations # music
POST /v1/audio/speech # TTS
POST /v1/audio/transcriptions # STT
POST /v1/audio/translationsCommunication
POST /v1/marketplace/phone/numbers/buy
POST /v1/marketplace/phone/numbers/renew
POST /v1/marketplace/phone/numbers/list
POST /v1/marketplace/phone/numbers/release
POST /v1/marketplace/phone/lookup
POST /v1/marketplace/phone/lookup/fraud
POST /v1/marketplace/phone/sms/send
POST /v1/marketplace/voice/call
POST /v1/marketplace/voice/call/transfer
POST /v1/marketplace/voice/call/endEvery phone endpoint is POST, including numbers/list. The GET forms return "Unknown phone endpoint" upstream.
Web & Search
POST /v1/marketplace/exa/search
POST /v1/marketplace/exa/contents
POST /v1/marketplace/exa/answer
POST /v1/marketplace/exa/find-similar # not yet available upstream
POST /v1/search # smart-routed summaryCompute & Infrastructure
POST /v1/marketplace/compute/sandbox/create
POST /v1/marketplace/compute/sandbox/exec
POST /v1/marketplace/compute/sandbox/status
POST /v1/marketplace/compute/sandbox/terminate
POST /v1/marketplace/rpc/{chain}All four sandbox operations are POST and take sandbox_id in the body — there are no /sandbox/:id/... path forms and no GET/DELETE variants.
Identity & RealFace
POST /v1/marketplace/realface/enroll
POST /v1/marketplace/realface/portrait/create
GET /v1/marketplace/realface/assets/:id
DELETE /v1/marketplace/realface/assets/:idNotes
/v1/images/*and/v1/audio/*follow the OpenAI-compatible format- Music generation goes through
/v1/audio/generations, not a separate/v1/music/*surface - Video and music job polling (
GET) is free — the read reuses the original payment - All payments settle via x402 (on-chain USDC), pay-per-call with no subscription
- Listed prices are reference rates;
price.amounton each response is the authoritative figure