Docs / Reference / REST
REST API
Every tool has a GET equivalent under /api/v1. CORS is open, responses are JSON, and the shapes match the MCP tools exactly.
| Endpoint | MCP equivalent |
|---|---|
GET /api/v1/search?q=pepe&limit=10 | search_tokens |
GET /api/v1/tokens/{id|symbol|address}?chain=base | get_token |
GET /api/v1/tokens/{id|symbol|address}/risk | get_risk_signals |
GET /api/v1/market?ids=bitcoin,ethereum | get_market_data (by id) |
GET /api/v1/market?limit=100&page=1 | get_market_data (top by cap) |
GET /api/v1/trending?source=dex&chain=solana&limit=15 | get_trending |
GET /api/v1/new?chain=base&minLiquidityUsd=10000 | get_new_tokens |
GET /api/v1/global | get_global_stats |
GET /api/health | Liveness + version |
GET /skill.md | Agent-readable instructions (Markdown) |
curl -s "https://coinfactory.ai/api/v1/tokens/pepe/risk" | jq '.level, .signals[0]'
Status codes: 400 invalid params (with issues[]), 404 unknown token, 429 you are over the rate limit, 502/503 an upstream provider failed or throttled us (honour retry-after).