For the complete documentation index, see llms.txt. This page is also available as Markdown.

Signals

Real-time cluster, entry and exit signals from tracked KOL, smart-money and whale wallets on Solana, BNB Chain, Base and Ethereum.

Live Signals — Cluster, Entry & Exit (per-type gate)

get

Returns live signals for one chain within a time window.

Gated parameters (presence of any one switches to gated mode):

  • kol, smart — entry tiers as a CSV of up to 3 ascending ints (kol=5 or kol=5,10,20). The smallest is the gate.

  • kol_min_buy, kol_max_buy, smart_min_buy, smart_max_buy — per-type cumulative-buy bounds (native units).

  • kol_exit, smart_exit — exit tiers as a CSV of up to 2 "still holding" counts (kol_exit=3,1).

  • include_wallets, exclude_wallets — comma-separated wallet lists.

  • min_win_rate (0–100), min_token_age, max_token_age (hours).

Legacy parameters (when no gated parameter is present):

  • type (kol/smart/whale), mode (cluster/entry/exit), min_wallets, min_value.

Common: blockchain (required), hours, limit, api_key.

Unknown parameters are ignored and reported in data.warnings.

Query parameters
blockchainstring · enumRequired

solana | bnb | base | eth

Possible values:
kolstringOptional

Gated: KOL entry tiers, CSV up to 3 ascending ints (e.g. 5 or 5,10,20).

Example: 5,10,20
smartstringOptional

Gated: smart-money entry tiers, CSV up to 3 ints.

Example: 2
kol_min_buynumberOptional

Gated: min cumulative KOL buy (native).

kol_max_buynumberOptional

Gated: max cumulative KOL buy (native).

kol_exitstringOptional

Gated: KOL exit tiers, CSV up to 2 "still holding" counts (e.g. 3,1).

Example: 3,1
smart_min_buynumberOptional
smart_max_buynumberOptional
smart_exitstringOptional

Gated: smart-money exit tiers, CSV up to 2.

include_walletsstringOptional

Gated: comma-separated wallets that alone count.

exclude_walletsstringOptional

Gated: comma-separated wallets to drop.

min_win_ratenumber · max: 100Optional

Gated: drop wallets below this lifetime win-rate (0–100).

min_token_agenumberOptional

Gated: min token age (hours).

max_token_agenumberOptional

Gated: max token age (hours).

typestring · enumOptional

Legacy: wallet type.

Possible values:
modestring · enumOptional

Legacy: cluster | entry | exit.

Possible values:
min_walletsinteger · min: 1Optional

Legacy: min wallets for a cluster.

Default: 3
min_valuenumberOptional

Legacy: ignore trades below this (native).

Default: 0
hoursnumberOptional

Window size in hours.

Default: 1
limitinteger · min: 1Optional
api_keystringOptional
Responses
200

Signals payload. In gated mode, data.gated is true and data.signals[] use the cluster model below.

application/json
successbooleanOptionalExample: true
get/v1/signals

Last updated