Getting Started

Base URL

https://api.conyr.ai

Authentication

All /v1/* endpoints require a Bearer token in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.conyr.ai/v1/wallet/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU/performance

The following endpoints are public and require no authentication: GET /health — liveness probe, GET /ready — readiness probe (checks core services), GET /metrics — Prometheus metrics, WS /ws — WebSocket connection.

Your First Request

Let’s check a wallet’s 7-day trading performance:

curl -s -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.conyr.ai/v1/wallet/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU/performance?window=7d" \
  | python3 -m json.tool

import requests
 
API_KEY = "YOUR_API_KEY"
BASE = "https://api.conyr.ai/v1"
 
wallet = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
resp = requests.get(
    f"{BASE}/wallet/{wallet}/performance",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"window": "7d"},
)
data = resp.json()
print(f"Win rate: {data['win_rate']:.1%}, PnL: ${data['total_pnl_usd']:,.2f}")

const API_KEY = "YOUR_API_KEY";
const BASE = "https://api.conyr.ai/v1";
 
const wallet = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU";
const resp = await fetch(
  `${BASE}/wallet/${wallet}/performance?window=7d`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const data = await resp.json();
console.log(`Win rate: ${(data.win_rate * 100).toFixed(1)}%, PnL: $${data.total_pnl_usd.toFixed(2)}`);

Response

{
  "wallet_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "total_trades": 142,
  "wins": 89,
  "losses": 53,
  "win_rate": 0.6267,
  "total_pnl_usd": 12450.32,
  "total_volume_usd": 98230.50,
  "total_fees_usd": 142.80,
  "avg_hold_time_seconds": 3420.5,
  "cash_pnl_usd": 11200.00
}

Error Handling

All errors return a consistent JSON format:

{"error": "Invalid window. Use 1d, 7d, or 30d", "code": 400}

⚠️

Always check the HTTP status code. Possible values: 200, 400, 401, 500, 503.

Next Steps

Free Tier

Buyer quality and bundle summary.

Market Data (Layer 1)

OHLCV candles, trades, ticks.

Wallet Intelligence (Layer 2)

PnL, positions, labels, profile, similarity, provenance.

Security Intelligence (Layer 3)

Bundles, coordination, wash trades, entanglement.

WebSockets

Real-time streaming.

Leaderboard

Find the best wallets.

Introduction Guides