Schemas

CryptoLatestPriceFullPayload

cid

integer · required

CoinMarketCap cryptocurrency ID

p

number · required

Spot price (USD)

vu

number

Volume / value (USD)

mc

number

Market cap (USD)

cs

number

Circulating supply

p24h

number

Price change % (24h, 0–100 scale)

p7d

number

Price change % (7d, 0–100 scale)

p30d

number

Price change % (30d, 0–100 scale)

p60d

number

Price change % (60d, 0–100 scale)

p3m

number

Price change % (3 months, 0–100 scale)

p1y

number

Price change % (1y, 0–100 scale)

pytd

number

Price change % (year-to-date, 0–100 scale)

pall

number

Price change % (all time, 0–100 scale)

fdv24h

number

Fully diluted MC 24h change % (0–100)

PlatformId

integer

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

KlineInterval

string · enum

Enum values:

30s

15m

30m

Candle interval for onchain@kline subscribe param

UniqueTraderInterval

string · enum

Enum values:

30s

15m

30m

Candle interval for onchain@unique_trader (up to 1d)

KlinePayload

o

number

Open price USD (kline)

h

number

High price (USD) — kline & token_metric.sts window high

l

number

Low price USD (kline & token_metric.sts window low)

c

number

Close price USD (kline)

vu

number

Volume / value (USD)

ot

integer · int64

Candle open time (epoch ms)

UniqueTraderPayload

ut

integer

Unique trader count

ot

integer · int64

Candle open time (epoch ms)

TransactionPayload

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

f

string

Factory / pool program address

bh

integer · int64

Block height / slot

tp

string · enum

Type discriminator: buy or sell (relative to token0)

Enum values:

buy

sell

pa

string

Pool / pair contract address

t0a

string

Token0 contract address

t1a

string

Token1 contract address

t0s

string

Token0 symbol

t1s

string

Token1 symbol

vu

number

Volume / value (USD)

q

number

Quote amount

t0pu

number

Token0 price (USD)

t1pu

number

Token1 price (USD)

tx

string

Transaction hash / signature

ts

integer · int64

Event timestamp (epoch ms)

ma

string

Maker wallet address

ba

string

Base token address of the pair

a0

number

Token0 amount (native units)

a1

number

Token1 amount (native units)

qi

integer

Quote token index (0 or 1)

tii

integer

Token-in index (0 or 1)

lgid

integer

Log index in transaction

ex

boolean

Excluded from aggregate metrics

txtp

integer

Tx classification code (0 = normal)

fee

number

Trading fee amount

feeu

number

Trading fee in USD

iix

integer

Solana instruction index (optional)

LiquidityEventPayload

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

f

string

Factory / pool program address

ts

integer · int64

Event timestamp (epoch ms)

tp

string · enum

Type discriminator: add, remove, or migrate

Enum values:

add

remove

migrate

t0s

string

Token0 symbol

t1s

string

Token1 symbol

t0a

string

Token0 contract address

t1a

string

Token1 contract address

a0

number

Token0 amount (native units)

a1

number

Token1 amount (native units)

vu

number

Volume / value (USD)

ma

string

Maker wallet address

tx

string

Transaction hash / signature

lgid

integer

Log index in transaction

iix

integer

Solana instruction index (optional)

TokenMetricWindowStats

win

string · enum

Time window (1m, 5m, 1h, 4h, 24h, 7d, …)

Enum values:

24h

vn

number

Volume (native)

vu

number

Volume / value (USD)

pc

number

Price change % in window (0–100 scale)

txs

integer

Total transaction count (in window)

bc

integer

Buy transaction count (in window)

sc

integer

Sell transaction count (in window)

bvu

number

Buy volume (USD)

svu

number

Sell volume (USD)

bvn

number | null

Buy volume (native)

svn

number | null

Sell volume (native)

ut

integer

Unique trader count

but

integer

Unique buyer count

sut

integer

Unique seller count

h

number

High price (USD) — kline & token_metric.sts window high

l

number

Low price USD (kline & token_metric.sts window low)

TokenMetricPayload

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

a

string

Token contract / mint address

p

number

Spot price (USD)

mc

number | null

Market cap (USD)

lu

number | null

Liquidity (USD)

TokenMetricWindowStats[]

Stats per rolling window (token_metric)

TokenAggEventPayload

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

a

string

Token contract / mint address

ap

number

Aggregated price USD across pools (preferred for UI)

p

number

Spot price (USD)

lu

number

Liquidity (USD)

ts

integer · int64

Event timestamp (epoch ms)

HolderMetricsPayload

Use string `tp` to determine which fields are set.

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

a

string

Token contract / mint address

tp

string · enum

Type discriminator: tag_distribution, holder_count, top_share, tag_pnl, or tag_balance

Enum values:

tag_distribution

holder_count

top_share

tag_pnl

tag_balance

ts

integer · int64

Event timestamp (epoch ms)

devp

number

[tp: tag_distribution] Dev wallet share % (0–100)

khc

integer

KOL holder count

whc

integer

Whale holder count

bdhc

integer

BotDegen holder count

shc

integer

Sniper holder count

bhc

integer

Bundle holder count

smhc

integer

Smart-money holder count

hc

integer

[tp: holder_count] Total holder count

ab

number

Average token balance across holders

hc10

integer

[tp: holder_count] Holders with > $10 USD balance

t10p

number

[tp: top_share] Top 10 holders share % (0–100)

t50p

number

[tp: top_share] Top 50 holders share % (0–100)

t100p

number

[tp: top_share] Top 100 holders share % (0–100)

t100ab

number

Avg balance of top 100 holders

object

Map: tag → PnL metrics (holders_metrics tp: tag_pnl)

object

Map: tag → balance stats (holders_metrics tp: tag_balance)

HolderTagPnl

t100abp

number

Avg buy price USD (top 100 of tag)

t100asp

number

Avg sell price USD (top 100 of tag)

t100rpnl

number

Realized PnL USD (top 100 of tag)

t100sp

number

Spot position (top 100 of tag)

t100bu

number

Total buy USD (top 100 of tag)

HolderTagBalance

tb

number

Tag total balance (holders_metrics tp: tag_balance)

thp

number

Tag holding share % (0–100)

hc

integer

Tag holder count (within tp: tag_balance map entry)

HolderFieldChangePayload

Use string `tp` to determine which fields are set.

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

wa

string

Wallet address

tp

string · enum

Type discriminator: token_balance, native_balance, pnl_stats, last_active, or position_time

Enum values:

token_balance

native_balance

pnl_stats

last_active

position_time

a

string | null

Token contract / mint address

bh

integer | null · int64

Block height / slot

ts

integer · int64

Event timestamp (epoch ms)

b

number

[tp: token_balance] Token balance (raw amount, not USD)

hp

number

[tp: token_balance] Holding share % (0–100)

nb

number

[tp: native_balance] Native coin balance (e.g. SOL amount)

rpnl

number

[tp: pnl_stats] Realized PnL (USD)

rpnlp

number

[tp: pnl_stats] Realized PnL ratio on 0–100 scale

tbv

number

Total buy volume (token amount)

tsv

number

Total sell volume (token amount)

bu

number

[tp: pnl_stats] Total buy notional (USD)

su

number

[tp: pnl_stats] Total sell notional (USD)

abp

number

[tp: pnl_stats] Average buy price (USD)

asp

number

[tp: pnl_stats] Average sell price (USD)

nbu

number

Net buy USD (buyUsd − sellUsd)

lat

integer · int64

[tp: last_active] Last on-chain activity time (epoch ms)

spot

integer · int64

[tp: position_time] Spot position open time (epoch ms)

spct

integer · int64

[tp: position_time] Spot position close time (epoch ms)

PoolMetricWindowStats

bvn

number

Buy volume (native)

bvu

number

Buy volume (USD)

svn

number

Sell volume (native)

svu

number

Sell volume (USD)

ut

integer

Unique trader count

but

integer

Unique buyer count

sut

integer

Unique seller count

PoolMetricPayload

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

pa

string

Pool / pair contract address

PoolMetricWindowStats

Rolling stats for 5-minute window

PoolMetricWindowStats

Rolling stats for 1-hour window

PoolMetricWindowStats

Rolling stats for 4-hour window

PoolMetricWindowStats

Rolling stats for 24-hour window

PoolMetricWindowStats

Rolling stats for 7-day window

CryptoLatestPriceFullPayload

cid

integer · required

CoinMarketCap cryptocurrency ID

p

number · required

Spot price (USD)

vu

number

Volume / value (USD)

mc

number

Market cap (USD)

cs

number

Circulating supply

p24h

number

Price change % (24h, 0–100 scale)

p7d

number

Price change % (7d, 0–100 scale)

p30d

number

Price change % (30d, 0–100 scale)

p60d

number

Price change % (60d, 0–100 scale)

p3m

number

Price change % (3 months, 0–100 scale)

p1y

number

Price change % (1y, 0–100 scale)

pytd

number

Price change % (year-to-date, 0–100 scale)

pall

number

Price change % (all time, 0–100 scale)

fdv24h

number

Fully diluted MC 24h change % (0–100)

TransactionPayload

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

f

string

Factory / pool program address

bh

integer · int64

Block height / slot

tp

string · enum

Type discriminator: buy or sell (relative to token0)

Enum values:

buy

sell

pa

string

Pool / pair contract address

t0a

string

Token0 contract address

t1a

string

Token1 contract address

t0s

string

Token0 symbol

t1s

string

Token1 symbol

vu

number

Volume / value (USD)

q

number

Quote amount

t0pu

number

Token0 price (USD)

t1pu

number

Token1 price (USD)

tx

string

Transaction hash / signature

ts

integer · int64

Event timestamp (epoch ms)

ma

string

Maker wallet address

ba

string

Base token address of the pair

a0

number

Token0 amount (native units)

a1

number

Token1 amount (native units)

qi

integer

Quote token index (0 or 1)

tii

integer

Token-in index (0 or 1)

lgid

integer

Log index in transaction

ex

boolean

Excluded from aggregate metrics

txtp

integer

Tx classification code (0 = normal)

fee

number

Trading fee amount

feeu

number

Trading fee in USD

iix

integer

Solana instruction index (optional)

LiquidityEventPayload

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

f

string

Factory / pool program address

ts

integer · int64

Event timestamp (epoch ms)

tp

string · enum

Type discriminator: add, remove, or migrate

Enum values:

add

remove

migrate

t0s

string

Token0 symbol

t1s

string

Token1 symbol

t0a

string

Token0 contract address

t1a

string

Token1 contract address

a0

number

Token0 amount (native units)

a1

number

Token1 amount (native units)

vu

number

Volume / value (USD)

ma

string

Maker wallet address

tx

string

Transaction hash / signature

lgid

integer

Log index in transaction

iix

integer

Solana instruction index (optional)

TokenMetricWindowStats

win

string · enum

Time window (1m, 5m, 1h, 4h, 24h, 7d, …)

Enum values:

24h

vn

number

Volume (native)

vu

number

Volume / value (USD)

pc

number

Price change % in window (0–100 scale)

txs

integer

Total transaction count (in window)

bc

integer

Buy transaction count (in window)

sc

integer

Sell transaction count (in window)

bvu

number

Buy volume (USD)

svu

number

Sell volume (USD)

bvn

number | null

Buy volume (native)

svn

number | null

Sell volume (native)

ut

integer

Unique trader count

but

integer

Unique buyer count

sut

integer

Unique seller count

h

number

High price (USD) — kline & token_metric.sts window high

l

number

Low price USD (kline & token_metric.sts window low)

HolderMetricsPayload

Use string `tp` to determine which fields are set.

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

a

string

Token contract / mint address

tp

string · enum

Type discriminator: tag_distribution, holder_count, top_share, tag_pnl, or tag_balance

Enum values:

tag_distribution

holder_count

top_share

tag_pnl

tag_balance

ts

integer · int64

Event timestamp (epoch ms)

devp

number

[tp: tag_distribution] Dev wallet share % (0–100)

khc

integer

KOL holder count

whc

integer

Whale holder count

bdhc

integer

BotDegen holder count

shc

integer

Sniper holder count

bhc

integer

Bundle holder count

smhc

integer

Smart-money holder count

hc

integer

[tp: holder_count] Total holder count

ab

number

Average token balance across holders

hc10

integer

[tp: holder_count] Holders with > $10 USD balance

t10p

number

[tp: top_share] Top 10 holders share % (0–100)

t50p

number

[tp: top_share] Top 50 holders share % (0–100)

t100p

number

[tp: top_share] Top 100 holders share % (0–100)

t100ab

number

Avg balance of top 100 holders

object

Map: tag → PnL metrics (holders_metrics tp: tag_pnl)

object

Map: tag → balance stats (holders_metrics tp: tag_balance)

HolderFieldChangePayload

Use string `tp` to determine which fields are set.

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

wa

string

Wallet address

tp

string · enum

Type discriminator: token_balance, native_balance, pnl_stats, last_active, or position_time

Enum values:

token_balance

native_balance

pnl_stats

last_active

position_time

a

string | null

Token contract / mint address

bh

integer | null · int64

Block height / slot

ts

integer · int64

Event timestamp (epoch ms)

b

number

[tp: token_balance] Token balance (raw amount, not USD)

hp

number

[tp: token_balance] Holding share % (0–100)

nb

number

[tp: native_balance] Native coin balance (e.g. SOL amount)

rpnl

number

[tp: pnl_stats] Realized PnL (USD)

rpnlp

number

[tp: pnl_stats] Realized PnL ratio on 0–100 scale

tbv

number

Total buy volume (token amount)

tsv

number

Total sell volume (token amount)

bu

number

[tp: pnl_stats] Total buy notional (USD)

su

number

[tp: pnl_stats] Total sell notional (USD)

abp

number

[tp: pnl_stats] Average buy price (USD)

asp

number

[tp: pnl_stats] Average sell price (USD)

nbu

number

Net buy USD (buyUsd − sellUsd)

lat

integer · int64

[tp: last_active] Last on-chain activity time (epoch ms)

spot

integer · int64

[tp: position_time] Spot position open time (epoch ms)

spct

integer · int64

[tp: position_time] Spot position close time (epoch ms)

PoolMetricPayload

pid

PlatformId

Platform / chain ID (numeric, e.g. 14 = BSC, 16 = Solana)

pa

string

Pool / pair contract address

PoolMetricWindowStats

Rolling stats for 5-minute window

PoolMetricWindowStats

Rolling stats for 1-hour window

PoolMetricWindowStats

Rolling stats for 4-hour window

PoolMetricWindowStats

Rolling stats for 24-hour window

PoolMetricWindowStats

Rolling stats for 7-day window