Token Scanner

Run read-only scanner modes for hot tokens, new runners, alpha drops, AI-themed tokens, and top new pairs. User presets, alerts, and task state remain app-only.

GET/v1/token-scanner/scan

Run scanner

Query parameters

Name
mode
Type
string
Description
hot, new-runners, alpha-drops, ai-top, or top-new. Default hot.
Name
chains
Type
string
Description
Comma-separated Dexscreener chain IDs for scanner modes except top-new.
Name
chain
Type
string
Description
Single chain for top-new. Default base.
Name
profile
Type
string
Description
discovery, balanced, or strict. Use the explicit threshold parameters below to tune a supported profile.
Name
days
Type
number
Description
Lookback window in days for scanner modes that support one.
Name
limit
Type
integer
Description
Maximum rows returned. Range 1-72. Default 50.
Name
minLiquidityUsd
Type
number
Description
Minimum liquidity in USD.
Name
minVolumeH24
Type
number
Description
Minimum 24h volume in USD.
Name
minTxnsH1
Type
number
Description
Minimum 1h transaction count.
Name
minTxnsH24
Type
number
Description
Minimum 24h transaction count.
Name
maxAgeHours
Type
number
Description
Maximum token-pair age in hours.
Name
includeUnknownAge
Type
string
Description
true or false.
Name
sortBy
Type
string
Description
score, readiness, rs, volume, or momentum.
Name
minBreakoutReadiness
Type
number
Description
Minimum breakout-readiness score.
Name
minRelativeStrength
Type
number
Description
Minimum relative-strength score.
Name
maxVolLiqRatio
Type
number
Description
Maximum 24h volume-to-liquidity ratio.
Name
minPriceChangeH1
Type
number
Description
Minimum 1h price change percentage.

Every response includes coverage.status (complete or partial) plus per-source attempted, succeeded, and failed fetch counts. A partial response is ranked only from sources that answered. marketCap and fdv remain null when Dexscreener does not provide a valuation; valuation-dependent riskScore is also null and riskCoverage is partial instead of treating missing data as zero. Boost velocity and fast-decay analytics are returned as null because the current source does not provide the time-series observations needed to calculate them. Decay filter parameters are therefore rejected.

curl -G https://www.sharpe.ai/api/v1/token-scanner/scan \
  -H "Authorization: Bearer sk_live_your_key_here" \
  --data-urlencode "mode=alpha-drops" \
  --data-urlencode "chains=solana,base" \
  --data-urlencode "limit=25"