API ReferenceMarket Data (Layer 1)

Layer 1 — Market Data

Real-time swaps, candles, trades, and token data across all supported DEX protocols. Parsed directly from Solana’s transaction stream with sub-second latency.

Includes all Free tier endpoints.

Rate limits: 100 REST req/min, 5 WebSocket connections, 50 token subscriptions, 7 days OHLCV history.


WebSocket Streams

events.token.{mint}.chart_tick

Channel: token:{mint}:ticks

Zero-latency raw trade ticks. Every swap event as it happens, no batching delay.

  • Fields: signature, wallet, direction, token_amount, sol_amount, price, dex_type, timestamp
  • No batching — published immediately on swap detection
  • Covers all supported DEX protocols

events.token.{mint}.ohlcv.{view}.{tf}

Channel: token:{mint}:ohlcv:{view}:{tf}

OHLCV candle stream at multiple timeframes.

  • Timeframes: 1s, 1m, 5m, 15m, 1h
  • Views: full (all trades), filtered (bot/wash removed)
  • Outlier-filtered to reject anomalous price spikes
  • Deduplicated to prevent double-counting

events.token.{mint}.tape

Channel: token:{mint}:trades

Last 50 trades per token, maintained as a rolling window.

  • Includes: wallet, direction, amounts, dex_type, fees

REST Endpoints

GET /v1/token/{mint}/score

Full multi-axis composite risk score with breakdown. Same endpoint as Free tier, but Layer 1 keys receive the full axis breakdown and sub-scores.

See [Free Tier → Token Score](/api-reference/free-tier#get-v1tokenmint score) for full response schema.


GET /v1/token/{mint}/price

Real-time token price from on-chain pool state.

Parameters

ParameterInTypeRequiredDescription
mintpathstringyesSolana token mint address

Example

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.conyr.ai/v1/token/EPjFWd.../price"

Response

{
  "token_mint": "EPjFWd...",
  "price_usd": 0.00245,
  "sol_price_usd": 152.30,
  "price_sol": 0.0000161,
  "source": "raydium",
  "timestamp": "2026-03-07T12:00:00Z"
}
  • Multi-source price discovery with automatic fallback
  • Low-latency caching for real-time accuracy

GET /v1/token/{mint}/ohlcv

Historical OHLCV candle data.

Parameters

ParameterInTypeRequiredDefaultConstraints
mintpathstringyes
timeframequerystringno1m1s, 1m, 5m, 15m, 1h
viewquerystringnofullfull, filtered
fromqueryintegernoUnix milliseconds
toqueryintegernoUnix milliseconds
limitqueryintegerno500Max 2000

Example

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.conyr.ai/v1/token/EPjFWd.../ohlcv?timeframe=5m&view=filtered&limit=100"

Response

{
  "candles": [
    {
      "bucket": "2026-03-07 14:30:00+00",
      "open": 0.00234,
      "high": 0.00256,
      "low": 0.00228,
      "close": 0.00245,
      "volume_token": 5000000.0,
      "volume_usd": 11725.0,
      "num_trades": 42,
      "buy_volume": 3200000.0,
      "sell_volume": 1800000.0,
      "vwap": 0.002345
    }
  ],
  "token_mint": "EPjFWd...",
  "timeframe": "5m",
  "view": "filtered"
}

Views

ViewIncludesBest For
fullAll swapsRaw market data, charting
filteredExcludes wash trades and bot activityClean analysis, fair pricing

Layer 1 limit: 7 days of OHLCV history. Cache TTL: 5 seconds. Extended retention available on higher tiers.


GET /v1/token/{mint}/trades

Recent trade history for a token across all wallets.

Parameters

ParameterInTypeRequiredDefaultConstraints
mintpathstringyes
limitqueryintegerno50Max 200
directionquerystringnobuy or sell
dexquerystringnoFilter by DEX name
min_size_usdquerynumbernoMinimum trade size in USD

Example

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.conyr.ai/v1/token/EPjFWd.../trades?limit=20&direction=buy&min_size_usd=100"

Response

{
  "trades": [
    {
      "signature": "5vGk...",
      "slot": 245678901,
      "timestamp": "2026-03-07 14:30:00",
      "wallet_address": "7xKXtg...",
      "token_amount": 500000.0,
      "direction": "buy",
      "dex_name": "raydium",
      "base_amount": 0.85,
      "base_price_usd": 152.30,
      "total_fees_usd": 0.012
    }
  ],
  "token_mint": "EPjFWd...",
  "limit": 20
}

Includes fee breakdown covering network fees and third-party platform fees.