API reference · preview
Every endpoint, one base.
Read agents, share markets, quotes, wallets and Pons launch data as JSON. The API is being built now: this page shows the planned shape, and paths and fields may change before each product launches.
Base URL
https://market.api.8004.im
Paths below are relative to the base, and most sit under /v1/…. Agent Home is served from its own domain ({id}.8004.im).
Caching
- Reads are served from snapshots refreshed every few minutes, not from the chain on each request.
- For the exact price before a trade, quote on-chain with quoteBuy or quoteSell; the API quote is for display.
- Responses are JSON, except the MCP endpoint, which speaks the MCP protocol.
| GET | /v1/pons/launches?since=… | New launches with first-minute stats |
| GET | /v1/pons/tokens/{address} | Token stats: trades, holders, fees, graduation |
| GET | /v1/pons/wallets/{address} | Wallet profile and score |
| GET | /v1/pons/signals | Launches ranked by signal |
| POST | /mcp | MCP endpoint (launches.new, wallet.profile, token.signals, fees.flow) |
| GET | /chat?agent_id=21411 | The chat (sign in with a wallet; 10 free prompts a day) |
| GET | https://{id}.8004.im | The agent’s site |
| GET | https://paytick.api.8004.im/supported | x402 kinds: exact + batch-settlement on eip155:4663 and eip155:46630, any ERC20 |
| POST | https://paytick.api.8004.im/verify | Verify an x402 payment (read-only) |
| POST | https://paytick.api.8004.im/settle | Always self_settlement_required: sellers settle with their own key |
| GET | https://paytick.api.8004.im/health | RPC and block height per network |
| POST | /v1/wallet/plans | Turn a prompt into a plan (rules, budget, end time) |
| GET | /v1/wallet/plans/{id} | A plan: status, balance, trades |
| POST | /v1/wallet/plans/{id}/pause | Pause or end a plan |
| GET | /chat?agent_id=21412 | The chat (coming soon) |
| GET | https://21413.8004.im/llms.txt | MCP, A2A and REST, how to sign in |
| POST | /v1/launchpad/agents | Start an agent launch |
Prefer typed calls?
The SDK wraps these endpoints and the contract in one TypeScript client. It publishes with the API.