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`	50	$0.00935/call (flat)	prediction-markets
2	~~Crypto Data (Surf)~~ — withdrawn 2026-09-06, returns 404	`/v1/marketplace/surf`	0	—	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.0055/call	crypto-data
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/protocols

Prediction Markets

GET  /v1/marketplace/prediction/markets/search?q=bitcoin
GET  /v1/marketplace/prediction/polymarket/markets?sort=volume
GET  /v1/marketplace/prediction/kalshi/markets
GET  /v1/marketplace/prediction/sports/markets
GET  /v1/marketplace/prediction/polymarket/leaderboard

Crypto Data (DeFi, DEX, spot prices)

Surf was withdrawn upstream on 2026-09-06; every /v1/marketplace/surf/* path returns 404. The live replacements:

GET  /v1/marketplace/defi/protocols
GET  /v1/marketplace/defi/chains
GET  /v1/marketplace/defi/yields
GET  /v1/marketplace/dex/price?chainId=8453&sellToken=...&buyToken=...&sellAmount=...
GET  /v1/marketplace/markets/crypto/price/BTC-USD

AI 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/translations

Communication

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/voice/call

Every phone endpoint is POST, including numbers/list. The GET forms return "Unknown phone endpoint" upstream.

Three routes were withdrawn

phone/sms/send, voice/call/transfer and voice/call/end are no longer served; the gateway answers 404. Note that voice/call IS live — phone/voice/call is not. The two prefixes carry same-named routes with different fates.

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 summary

Compute & 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/:id

Notes

/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.amount on each response is the authoritative figure

Marketplace Endpoints Overview ​

Authentication ​

Service Directory ​

Quick Reference by Category ​

Financial Data & Trading ​

Prediction Markets ​

Crypto Data (DeFi, DEX, spot prices) ​

AI Generation ​

Communication ​

Web & Search ​

Compute & Infrastructure ​

Identity & RealFace ​

Notes ​