# CONYR API

> The deepest Solana intelligence API. Sub-second realized + unrealized PnL, FIFO position tracking, AI wallet taxonomy (22 badges), coordinated bundle detection, 5-axis token health scores, wallet provenance, 30-dim behavioral vectors, and organic OHLCV candles. REST + WebSocket for every data type.

## Base URL

https://api.conyr.ai

## Auth

Bearer token in Authorization header. All /v1/* endpoints require auth. Health/ready/metrics/ws do not.

## Docs

- [OpenAPI Spec](https://docs.conyr.ai/openapi.yaml): Full OpenAPI 3.1 machine-readable specification
- [Human Docs](https://docs.conyr.ai): Developer documentation with examples and guides
- [Agent Docs](https://docs.conyr.ai/agents): Structured reference for AI agents
- [Full Context](https://docs.conyr.ai/llms-full.txt): Complete API reference in plain text

## REST Endpoints

### Wallets
- GET /v1/wallets/{address}/performance — Trading stats (wins, losses, PnL, volume, Sharpe, profit factor)
- GET /v1/wallets/{address}/trades — Realized trade history with FIFO cost-basis, hold time, entry/exit prices, fee breakdown, trade tool fingerprint
- GET /v1/wallets/{address}/unrealized-pnl — Unrealized PnL on open positions (mark-to-market via vetted live prices, per-position and aggregate)
- GET /v1/wallets/{address}/positions — Open/closed token positions (lot-level FIFO accounting, fragment tracking)
- GET /v1/wallets/{address}/labels — Behavioral classification (trader type, performance level, size class, exit style, quantitative metrics)
- GET /v1/wallets/{address}/taxonomy — 4-axis classification + 22 badges (trade badges + identity badges with confidence)
- GET /v1/wallets/{address}/bundles — Coordinated wallet bundles (7 types, lifecycle tracking, supply-at-risk, leader reputation)
- GET /v1/wallets/{address}/security — Malicious activity score, detection reason, associated suspicious tokens

### Tokens
- GET /v1/tokens/{mint}/info — Token metadata + 5-axis health score (0-100): contract, bundle threat, deployer risk, holder quality, market integrity
- GET /v1/tokens/{mint}/ohlcv — OHLCV candles (1s/1m/5m/15m/1h, full/filtered views, buy/sell split, VWAP, unique buyers/sellers)
- GET /v1/tokens/{mint}/trades — Recent swap history for a token

### Leaderboard
- GET /v1/leaderboard — Ranked wallets by PnL, ROI, or win rate

### Operations (no auth)
- GET /health — Liveness probe
- GET /ready — Readiness probe
- GET /metrics — Prometheus metrics

## WebSocket Live Streams (wss://api.conyr.ai/ws)

Every major REST endpoint has a real-time WebSocket counterpart. Sub-second latency.

- wallet:{address}:pnl — REAL-TIME REALIZED PNL (fires on every trade close, sub-second, unique to CONYR)
- wallet:{address}:unrealized-pnl — Unrealized PnL updates on open positions (mark-to-market as prices move)
- wallet:{address}:positions — Position open/update/close events
- wallet:{address}:bundles — Bundle detection and lifecycle state changes
- wallet:{address}:security — Threat detection events
- wallet:{address}:taxonomy — Badge and classification changes
- token:{mint}:trades — Live trade tape (every swap as it happens)
- token:{mint}:ticks — Chart tick price updates
- token:{mint}:ohlcv:{view}:{tf} — Candle updates (view: full|filtered, tf: 1s|1m|5m|15m|1h)

Subscribe: {"op": "subscribe", "channels": ["wallet:ADDR:pnl", "token:MINT:trades"]}
Max 50 subscriptions per connection. No auth required for WebSocket.

## Data Depth

CONYR computes intelligence live, not raw transaction dumps:
- Realized PnL: FIFO cost-basis, cumulative position tracking, arbitrage attribution, fee breakdown, trade tool fingerprinting (Photon, BullX, Axiom, Bloom)
- Unrealized PnL: Mark-to-market on every open position using vetted live prices, per-position and aggregate totals
- Labels: 4-axis taxonomy (trader type, performance, size class, exit style) derived from closed-position outcomes
- Badges: 11 trade badges (RUNNER_KEEPER, ELITE_TRADER, DIAMOND_HANDS, etc.) + 13 identity badges (HFT_BOT, FUNDED_BY_FARM, ROOT_CEX, etc.)
- Bundles: 7 types (SybilPoisoning, CexCoordinated, JitoSequential, etc.), lifecycle states (active→dumping→rugged), member-level tracking
- Token Health: 5-axis composite score with raw signal snapshots for auditability
- Provenance: Funding chain traced to root source, farm detection, freshness signals
- Vectors: 30-dim behavioral fingerprint for nearest-neighbor wallet similarity search
- OHLCV: Full + filtered (organic) candles, 12+ DEXes parsed from raw transactions