API ReferenceFree Tier

Free Tier

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

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


GET /v1/token/{mint}/score

Composite token risk score from 0 (dangerous) to 100 (safe).

5-axis scoring:

  • Contract — mintable, freezable, flagged reasons, validation status
  • Bundle — supply at risk, bundle types, realized profit extracted
  • Deployer — deployer cross-referenced against malicious wallet registry
  • Holder — organic vs. bot vs. farm-funded holder composition
  • Market — buy/sell ratio, unique wallets, volume concentration

Parameters

ParameterInTypeRequiredDescription
mintpathstringyesSolana token mint address

Example

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

Response

{
  "token_mint": "EPjFWd...",
  "score": 72,
  "score_label": "moderate",
  "score_version": 2,
  "contract_score": 85,
  "bundle_score": 55,
  "deployer_score": 90,
  "holder_score": 68,
  "market_score": 74,
  "contract_evidence": ["Token is not mintable", "Token is not freezable"],
  "bundle_evidence": ["2 active bundles controlling 12.5% of supply"],
  "deployer_evidence": ["Deployer has no flagged tokens"],
  "holder_evidence": ["62% organic wallets", "15% bot-operated"],
  "market_evidence": ["Buy/sell ratio: 1.3", "142 unique wallets"],
  "sig_bundled_supply_pct": 12.5,
  "sig_open_bundle_count": 2,
  "sig_deployer_is_malicious": false,
  "sig_deployer_rugged_ct": 0,
  "sig_organic_pct": 62.0,
  "sig_bot_pct": 15.0,
  "sig_unique_wallets": 142,
  "sig_buy_sell_ratio": 1.3,
  "computed_at": "2026-03-07T12:00:00Z"
}

Score Labels

ScoreLabelMeaning
75–100goodLow risk across all axes
50–74moderateSome flags — review evidence
25–49riskySignificant concerns
0–24dangerousHigh risk of rug or manipulation

Cache TTL: 10 seconds.


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.