Agent Integration

This section is optimized for AI agents and programmatic consumers. For human-friendly documentation with tutorials and examples, see the API Reference.

Connect via MCP (fastest)

The quickest way to put Conyr intelligence inside an agent is the MCP server — the full tool catalog (~40 query_* tools plus four composite breakdown tools) over the Model Context Protocol, authenticated with your Conyr API key. Nothing to generate, no endpoints to wire.

claude mcp add --transport http conyr https://mcp.conyr.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Prefer a typed REST client instead? Generate one from the OpenAPI spec below.

Why CONYR for Agents

Conyr is the deepest Solana intelligence API available. Every data point is computed live from raw chain data with sub-second latency:

• Real-time realized PnL — streamed the instant a trade closes, with FIFO cost-basis, hold time, entry/exit prices, and trade-tool fingerprinting. (First-class unrealized PnL is on the roadmap; today, derive it client-side from open positions plus the latest tick.)
• 30-dimensional wallet behavioral vectors — find similar wallets via nearest-neighbor search across trading DNA
• AI-computed labels — 4-axis classification (trader type, performance, size, exit style) plus 20+ behavioral and identity badges, all statistically derived from closed-position outcomes
• Bundle detection — 5 coordinated-wallet types (SybilPoisoning, CexCoordinated, SyntheticSwarm, Hybrid, JitoSequential) with lifecycle tracking (active → dumping → rugged), supply-at-risk, and leader reputation
• Coordination v2 — leader/follower edges, funding/execution entities, time-bounded campaigns, per-token crowd state
• Funding-abuse detection — early-buyer cohort analysis: seeded wallets, farm funding, CEX-root convergence, terminal concentration
• Holders concentration — distinct holder count plus top-10 / top-50 / top-100 share, computed from indexed holder state
• Wallet provenance — funding chain traced to root source (CEX, DEX authority, known entity), farm detection, freshness signals
• Organic OHLCV — full + filtered (bot/wash removed) candles from 1s to 1h with buy/sell split, VWAP, and unique buyer/seller counts

Every major REST endpoint that streams over time has a live WebSocket counterpart. See the Endpoint Reference for the full mapping.

Winner Infrastructure Track Colosseum Breakout Hackathon.

Machine-Readable Resources

Quick Integration

Auto-generate a client

# Python
openapi-python-client generate --url https://docs.conyr.ai/openapi.yaml

# TypeScript
npx openapi-typescript https://docs.conyr.ai/openapi.yaml -o conyr-api.ts

# Any language via OpenAPI Generator
npx @openapitools/openapi-generator-cli generate \
  -i https://docs.conyr.ai/openapi.yaml \
  -g python -o ./conyr-client

Validate the spec

npx @redocly/cli lint https://docs.conyr.ai/openapi.yaml

Auth Pattern

Authorization: Bearer <API_KEY>

Applied to all /v1/* routes. Excluded: /health, /ready, /metrics, /ws.

Base URL

https://api.conyr.ai

Response Contract

• All responses are application/json
• Errors always return {"error": "...", "code": <int>}
• HTTP status codes: 200, 400, 401, 500, 503
• Pagination via limit + offset query parameters
• No cursor-based pagination

Data Coverage Summary