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, strict, or custom.
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-200. 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
decayFilter
Type
string
Description
true or false.
Name
minHalfLifeMinutes
Type
number
Description
Minimum volume half-life in minutes.
Name
minDecayRatio
Type
number
Description
Minimum decay ratio.
Name
maxVolLiqRatio
Type
number
Description
Maximum 24h volume-to-liquidity ratio.
Name
minPriceChangeH1
Type
number
Description
Minimum 1h price change percentage.

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"