API ReferenceFree Tier

Free Tier

Rate-limited access to core intelligence endpoints. Designed for evaluation, prototyping, and hobby projects.

Rate limits: 5 req/min (buyer-quality, bundles/summary). No WebSocket access.


GET /v1/token/{mint}/buyer-quality

Classifies recent buyers into quality tiers with volume decomposition.

Buyer Tiers

TierDescription
elite_smart_moneyTop-performing profitable wallets with elite track records
consistent_organicConsistently profitable organic wallets
developing_organicOrganic wallets still building track record
bot_operatedAutomated / bot-driven wallets
farm_fundedWallets funded by known farm distributors
unrated_newNo behavioral profile yet

Parameters

ParameterInTypeRequiredDefaultDescription
mintpathstringyesSolana token mint address
window_hoursqueryintegerno1Lookback window in hours

Example

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.conyr.ai/v1/token/EPjFWd.../buyer-quality?window_hours=1"

Response

{
  "token_mint": "EPjFWd...",
  "window_hours": 1,
  "smart_money_signal": 0.42,
  "total_buyers": 87,
  "volume_decomposition": {
    "organic_profitable_usd": 12500.0,
    "organic_other_usd": 8200.0,
    "bot_usd": 5400.0,
    "farm_funded_usd": 1200.0,
    "unrated_usd": 3100.0
  },
  "tiers": {
    "elite_smart_money": { "count": 5, "volume_usd": 8200.0 },
    "consistent_organic": { "count": 12, "volume_usd": 4300.0 },
    "developing_organic": { "count": 28, "volume_usd": 8200.0 },
    "bot_operated": { "count": 18, "volume_usd": 5400.0 },
    "farm_funded": { "count": 6, "volume_usd": 1200.0 },
    "unrated_new": { "count": 18, "volume_usd": 3100.0 }
  }
}

The smart_money_signal is the percentage of total volume from profitable organic wallets (elite + consistent). Higher is better.

Cache TTL: 30 seconds.


GET /v1/token/{mint}/bundles/summary

Active bundle count and top-level classification for a token.

Parameters

ParameterInTypeRequiredDescription
mintpathstringyesSolana token mint address

Example

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

Response

{
  "token_mint": "EPjFWd...",
  "bundle_count": 3,
  "open_bundle_count": 2,
  "bundled_supply_pct": 18.5,
  "bundled_value_usd": 24500.0,
  "bundled_realized_pnl_usd": 3200.0,
  "dominant_bundle_type": "SybilPoisoning"
}

Cache TTL: 15 seconds.