%20--%3e%3cg%20fill='%23C6F82A'%3e%3crect%20x='13'%20y='15'%20width='38'%20height='10'%20rx='1.5'/%3e%3cpath%20d='M37%2025%20L37%2047.5%20Q37%2049%2035.5%2049%20L28%2049%20Q26.5%2049%2026.5%2047.5%20L26.5%2036%20Z'/%3e%3c/g%3e%3c/svg%3e)
Integration overview
On-chain truth, REST index, Socket.IO realtime, read-only MCP.
Integrators talk to Trancepad in four layers: on-chain contracts (source of truth for launches and trades), the JSON REST API (indexing, discovery, auth), Socket.IO (realtime updates), and a read-only MCP server for agents. There is no published npm SDK yet. Use ABIs under shared/abis with viem or ethers, or wire MCP for agents.
Trust path
Trades and launches are signed by the user's wallet. POST /buy, POST /sell, and POST /tokens/create sync confirmed receipts into the index. They do not submit swaps. MCP never signs or submits transactions.
First success path
- Hit
GET /healthagainst your API base. - Complete SIWE auth for JWT-protected writes.
- List tokens with
GET /tokens, or launch via Router then sync create. - Optional: wire MCP for Cursor or Claude against the same API base.
curl -sS "${API_URL}/health" | jq .Routes mount at both / and /api/*. Prefer one prefix consistently. Envelope: { "success": true, "data": T }.
Labs bot control and admin pause routes exist for operators. They are not covered in these public pages. See repo runbooks if you operate a deployment.