Agent Integration

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

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 + unrealized PnL — realized PnL streamed the instant a trade closes, with FIFO cost-basis, hold time, entry/exit prices, and trade tool fingerprinting; unrealized PnL on every open position using vetted live prices
30-dimensional wallet behavioral vectors — find similar wallets via nearest-neighbor search across trading DNA
AI-computed taxonomy — 4-axis classification (trader type, performance, size, exit style) + 22 behavioral and identity badges, all statistically derived from closed-position outcomes
Bundle detection — 7 coordinated-wallet types with lifecycle tracking (active → dumping → rugged), supply-at-risk, and leader reputation
Token health scores — 5-axis composite (0-100) covering contract risk, bundle threat, deployer history, holder quality, and market integrity
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
Time-series analytics — minute/hourly/daily wallet metrics, heatmaps, PnL calendars

Every REST endpoint that returns trades, positions, or candles has a live WebSocket stream counterpart. See the Endpoint Reference for the full mapping.

Winner Infrastructure Track Colosseum Breakout Hackathon.

Machine-Readable Resources

Resource	URL	Format
OpenAPI 3.1 Spec	`/openapi.yaml`	YAML
LLM Context (short)	`/llms.txt`	Plain text
LLM Context (full)	`/llms-full.txt`	Plain text

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

Domain	What You Get
Wallet PnL	FIFO realized PnL per exit, unrealized PnL on open positions (mark-to-market via vetted prices), cumulative position tracking, arbitrage attribution, fee breakdown
Wallet Positions	Lot-level FIFO tracking, fragment support for DCA entries, real-time status
Wallet Labels	Trader type, performance level, size class, exit style, 11 trade badges, 13+ identity badges
Wallet Provenance	Funder, root source, hop count, farm detection, freshness signals
Wallet Vectors	30-dim behavioral fingerprint across timing, discipline, performance, sizing, infrastructure, provenance
Wallet Time-Series	Minute/hourly/daily PnL, volume, win/loss, heatmaps, calendars
Bundles	7 bundle types, lifecycle states, member-level balances, leader reputation, supply-at-risk
Token Health	5-axis score (0-100): contract, bundle threat, deployer risk, holder quality, market integrity
Token OHLCV	Full + filtered candles (1s-1h), buy/sell split, VWAP, unique buyers/sellers
DEX Coverage	12+ DEXes parsed from raw transactions: Raydium, PumpFun, PumpSwap, Meteora, BonkBot, Whirlpool, Jupiter

Guides OpenAPI Spec