EVM DEX Profile

Wallet Profile

Aggregated trading profile for a wallet, capturing outcomes of trading activity with financial-grade precision across configurable time windows.

Field	Type	Description
`updated_at`	String [date-time]	Timestamp of when the profile’s underlying data was last updated.
`synced_at`	String [date-time]	Timestamp of when the updated profile was last persisted to the database and made available through the API.
`chain_id`	Integer	Chain the profile is scoped to
`wallet_address`	String [address]	Wallet address
`metadata`	Metadata	Wallet metadata
`metrics`	Metrics	Wallet metrics

Metadata

Information about the wallet’s recent activity. Object

Field	Type	Description
`last_trade_at`	String [date-time]	Timestamp of the wallet’s last trade

Metrics

Wallet trading metrics computed across multiple rolling time windows, allowing comparison of recent versus longer-term performance. Map(Time Window, Metrics)

Key	Value	Description
`1d`	Metrics	Metrics for the last 1 day
`3d`	Metrics	Metrics for the last 3 days
`7d`	Metrics	Metrics for the last 7 days
`14d`	Metrics	Metrics for the last 14 days
`30d`	Metrics	Metrics for the last 30 days

Performance Metrics

Outcome-oriented metrics summarizing the profitability of the wallet’s trading. Object

Field	Type	Description
`pnl`	Number [USD]	Total profit and loss
`win_pnl`	Number [USD]	Total profit from winning trades
`loss_pnl`	Number [USD]	Total loss from losing trades
`roi`	Number [%]	Return on investment
`volume_weighted_roi`	Number [%]	ROI weighted by trade volume
`time_weighted_roi`	Number [%]	ROI weighted by holding duration
`winrate`	Number [%]	Ratio of winning trades
`volume_weighted_winrate`	Number [%]	Winrate weighted by trade volume
`token_roi_distribution`	ROI Distribution	ROI distribution
`largest_win`	Number [USD]	Largest single winning trade
`largest_loss`	Number [USD]	Largest single losing trade

Volume Metrics

Metrics describing the size and flow of capital the wallet has traded. Object

Field	Type	Description
`volume`	Number [USD]	Total trading volume
`buy_volume`	Number [USD]	Total buy volume
`sell_volume`	Number [USD]	Total sell volume
`avg_buy_size`	Number [USD]	Average buy trade size
`avg_sell_size`	Number [USD]	Average sell trade size
`avg_buy_mcap`	Number [USD]	Average token market cap at buy time
`avg_sell_mcap`	Number [USD]	Average token market cap at sell time
`turnover`	Number [ratio]	Portfolio turnover ratio

Trade Count Metrics

Counts that quantify how often and how actively the wallet trades. Object

Field	Type	Description
`trade_count`	Integer	Total number of trades
`buy_count`	Integer	Total number of buy trades
`sell_count`	Integer	Total number of sell trades
`position_count`	Integer	Total number of positions opened
`win_count`	Integer	Number of winning trades
`loss_count`	Integer	Number of losing trades
`max_consecutive_wins`	Integer	Longest streak of consecutive winning trades
`max_consecutive_losses`	Integer	Longest streak of consecutive losing trades

Daily Averages

Metrics normalized to a daily basis, summarizing the wallet’s typical day of trading. Object

Field	Type	Description
`avg_daily_pnl`	Number [USD]	Average daily PnL
`avg_daily_roi`	Number [%]	Average daily ROI
`avg_daily_trade_count`	Integer	Average number of trades per day
`avg_daily_traded_tokens`	Integer	Average number of unique tokens traded per day
`avg_daily_volume`	Number [USD]	Average daily trading volume

Per-Trade Averages

Averages that describe the wallet’s typical single-trade behavior and outcomes. Object

Field	Type	Description
`avg_pnl`	Number [USD]	Average PnL per trade
`avg_roi`	Number [%]	Average ROI per trade
`avg_token_pnl`	Number [USD]	Average PnL per token traded
`avg_token_roi`	Number [%]	Average ROI per token traded
`avg_holding_duration`	Integer [seconds]	Average position holding time
`avg_trade_delta`	Integer [seconds]	Average time between consecutive trades

Risk Metrics

Metrics that quantify the wallet’s risk profile and contextualize its returns relative to the risk taken. Object

Field	Type	Description
`risk_score`	Number [0-100]	Composite risk score
`consistency_score`	Number [0-100]	Trading consistency score
`sharpe_ratio`	Number [ratio]	Risk-adjusted return
`sortino_ratio`	Number [ratio]	Downside risk-adjusted return
`max_drawdown`	Number [%]	Maximum portfolio drawdown
`risk_of_ruin`	Number [%]	Estimated probability of complete capital loss
`profit_factor`	Number [ratio]	Ratio of gross profit to gross loss
`profit_expectancy`	Number [USD]	Expected profit per trade
`recovery_factor`	Number [ratio]	Net profit divided by maximum drawdown

Stability Metrics

Metrics that quantify how consistent the wallet’s performance is over time. Object

Field	Type	Description
`winrate_stability`	Number [%]	Consistency of winrate over time
`winrate_volatility`	Number [%]	Variance of winrate over time
`pnl_stability`	Number [%]	Consistency of PnL over time
`pnl_volatility`	Number [%]	Variance of PnL over time
`roi_stability`	Number [%]	Consistency of ROI over time
`roi_volatility`	Number [%]	Variance of ROI over time

Ratio Metrics

Comparative ratios that contextualize the quality and balance of the wallet’s trading outcomes. Object

Field	Type	Description
`pnl_volume_ratio`	Number [ratio]	PnL relative to total volume traded
`token_hit_ratio`	Number [%]	Ratio of profitable tokens to total tokens traded
`win_loss_size_ratio`	Number [ratio]	Average winning trade size divided by average losing trade size

Token Profile

Aggregated trading profile for a token, capturing how it is traded on a single chain, by whom, how profitably, and with what consistency.

Field	Type	Description
`updated_at`	String [date-time]	Timestamp of when the profile’s underlying data was last updated.
`synced_at`	String [date-time]	Timestamp of when the updated profile was last persisted to the database and made available through the API.
`chain_id`	Integer	Chain the profile is scoped to
`token_address`	String [address]	Token contract address
`metadata`	Metadata	Token metadata
`metrics`	Metrics	Token metrics

Metadata

Information about the token’s recent activity. Object

Field	Type	Description
`last_trade_at`	String [date-time]	Timestamp of the last trade

Metrics

Token-level trading metrics computed across multiple rolling time windows. Map(String, Object)

Key	Value	Description
`1m`	Object(Volume & Trade Metrics)	Metrics for the last 1 minute
`5m`	Object(Volume & Trade Metrics)	Metrics for the last 5 minutes
`1h`	Object(Volume & Trade Metrics)	Metrics for the last 1 hour
`6h`	Object(Volume & Trade Metrics)	Metrics for the last 6 hours
`1d`	Object(Volume & Trade Metrics)	Metrics for the last 1 day
`7d`	Object(Volume & Trade Metrics)	Metrics for the last 7 days

Volume & Trade Metrics

Aggregate measures of how much and how often the token has been traded. Object

Field	Type	Description
`volume`	Number [USD]	Total trading volume
`buy_volume`	Number [USD]	Total buy volume
`sell_volume`	Number [USD]	Total sell volume
`trade_count`	Integer	Total number of trades
`buy_count`	Integer	Total number of buy trades
`sell_count`	Integer	Total number of sell trades
`position_count`	Integer	Total number of positions opened

Participant Metrics

Counts describing how many unique wallets have interacted with the token. Object

Field	Type	Description
`makers_count`	Integer	Number of unique wallets that traded this token
`buyers_count`	Integer	Number of unique wallets that bought this token
`sellers_count`	Integer	Number of unique wallets that sold this token

PnL Metrics

Aggregate profit and loss outcomes generated across all wallets trading the token. Object

Field	Type	Description
`pnl`	Number [USD]	Net PnL across all traders
`win_pnl`	Number [USD]	Total profit from winning positions
`loss_pnl`	Number [USD]	Total loss from losing positions
`win_position_count`	Integer	Number of profitable positions
`loss_position_count`	Integer	Number of losing positions
`largest_trade_win`	Number [USD]	Largest single winning trade
`largest_trade_loss`	Number [USD]	Largest single losing trade

Price Metrics

Average price and market-cap levels observed across the token’s trading activity. Object

Field	Type	Description
`avg_price`	Number [USD]	Average trade price
`avg_buy_price`	Number [USD]	Average buy price
`avg_sell_price`	Number [USD]	Average sell price
`avg_buy_mcap`	Number [USD]	Average token market cap at buy time
`avg_sell_mcap`	Number [USD]	Average token market cap at sell time

Size Metrics

Typical trade and position sizing observed for the token. Object

Field	Type	Description
`avg_buy_size`	Number [USD]	Average buy trade size
`avg_sell_size`	Number [USD]	Average sell trade size
`avg_holding_duration`	Integer [seconds]	Average position holding duration

Per-Trade Averages

Averages that describe the typical outcomes of a single trade of the token. Object

Field	Type	Description
`avg_trade_pnl`	Number [USD]	Average PnL per trade
`avg_trade_roi`	Number [%]	Average ROI per trade

Wallet Performance Metrics

Average performance achieved by the wallets that traded the token. Object

Field	Type	Description
`avg_wallet_winrate`	Number [%]	Average winrate across wallets trading this token
`avg_wallet_pnl`	Number [USD]	Average PnL per wallet
`avg_wallet_roi`	Number [%]	Average ROI per wallet

Ratio Metrics

Comparative ratios that contextualize the quality and balance of trading outcomes around the token. Object

Field	Type	Description
`volume_weighted_winrate`	Number [%]	Winrate weighted by trade volume
`volume_weighted_roi`	Number [%]	ROI weighted by trade volume
`wallet_hit_ratio`	Number [%]	Ratio of profitable wallets to total wallets
`profit_factor`	Number [ratio]	Ratio of gross profit to gross loss
`win_loss_size_ratio`	Number [ratio]	Average winning trade size divided by average losing trade size
`pnl_volume_ratio`	Number [ratio]	PnL relative to total volume traded

Stability Metrics

Metrics that quantify how consistent the token’s price and trading outcomes are over time. Object

Field	Type	Description
`price_stability`	Number [%]	Consistency of price over time
`price_volatility`	Number [%]	Variance of price over time
`roi_stability`	Number [%]	Consistency of ROI over time
`roi_volatility`	Number [%]	Variance of ROI over time
`pnl_stability`	Number [%]	Consistency of PnL over time
`pnl_volatility`	Number [%]	Variance of PnL over time

Risk Metrics

Metrics that quantify the token’s risk profile and contextualize its returns relative to that risk. Object

Field	Type	Description
`sharpe_ratio`	Number [ratio]	Risk-adjusted return
`sortino_ratio`	Number [ratio]	Downside risk-adjusted return
`max_drawdown`	Number [%]	Maximum price drawdown

Position Profile

Aggregated trading profile for a wallet-token position, capturing the outcomes of that position’s trading activity across configurable time windows.

Field	Type	Description
`updated_at`	String [date-time]	Timestamp of when the profile’s underlying data was last updated.
`synced_at`	String [date-time]	Timestamp of when the updated profile was last persisted to the database and made available through the API.
`chain_id`	Integer	Chain the profile is scoped to
`position_address`	String [address]	Unique identifier for the position
`wallet_address`	String [address]	Wallet address holding the position
`token_address`	String [address]	Token contract address of the position
`metadata`	Metadata	Position metadata
`metrics`	Metrics	Position metrics

Metadata

Identifying information about the position’s recent activity. Object

Field	Type	Description
`last_trade_at`	String [date-time]	Timestamp of the position’s last trade

Metrics

Position trading metrics computed across multiple rolling time windows, allowing comparison of recent versus longer-term performance. Map(Time Window, Object)

Key	Value	Description
`1d`	Object	Metrics for the last 1 day
`3d`	Object	Metrics for the last 3 days
`7d`	Object	Metrics for the last 7 days

Performance Metrics

Outcome-oriented metrics summarizing the profitability of the position’s trading. Object

Field	Type	Description
`pnl`	Number [USD]	Total profit and loss
`win_pnl`	Number [USD]	Total profit from winning trades
`loss_pnl`	Number [USD]	Total loss from losing trades
`roi`	Number [%]	Return on investment
`volume_weighted_roi`	Number [%]	ROI weighted by trade volume
`winrate`	Number [%]	Ratio of winning trades
`volume_weighted_winrate`	Number [%]	Winrate weighted by trade volume
`largest_win`	Number [USD]	Largest single winning trade
`largest_loss`	Number [USD]	Largest single losing trade

Volume Metrics

Metrics describing the size and flow of capital traded in the position. Object

Field	Type	Description
`volume`	Number [USD]	Total trading volume
`buy_volume`	Number [USD]	Total buy volume
`sell_volume`	Number [USD]	Total sell volume
`avg_buy_size`	Number [USD]	Average buy trade size
`avg_sell_size`	Number [USD]	Average sell trade size
`avg_buy_mcap`	Number [USD]	Average token market cap at buy time
`avg_sell_mcap`	Number [USD]	Average token market cap at sell time
`turnover`	Number [ratio]	Portfolio turnover ratio

Trade Count Metrics

Counts that quantify how often and how actively the position has been traded. Object

Field	Type	Description
`trade_count`	Integer	Total number of trades
`buy_count`	Integer	Total number of buy trades
`sell_count`	Integer	Total number of sell trades
`win_count`	Integer	Number of winning trades
`loss_count`	Integer	Number of losing trades
`max_consecutive_wins`	Integer	Longest streak of consecutive winning trades
`max_consecutive_losses`	Integer	Longest streak of consecutive losing trades

Daily Averages

Metrics normalized to a daily basis, summarizing the position’s typical day of trading. Object

Field	Type	Description
`avg_daily_pnl`	Number [USD]	Average daily PnL
`avg_daily_roi`	Number [%]	Average daily ROI
`avg_daily_trade_count`	Integer	Average number of trades per day
`avg_daily_volume`	Number [USD]	Average daily trading volume

Per-Trade Averages

Averages that describe the position’s typical single-trade behavior and outcomes. Object

Field	Type	Description
`avg_pnl`	Number [USD]	Average PnL per trade
`avg_roi`	Number [%]	Average ROI per trade
`avg_holding_duration`	Integer [seconds]	Average position holding time
`avg_trade_delta`	Integer [seconds]	Average time between consecutive trades

Risk Metrics

Metrics that quantify the position’s risk profile and contextualize its returns relative to the risk taken. Object

Field	Type	Description
`risk_score`	Number [0-100]	Composite risk score
`consistency_score`	Number [0-100]	Trading consistency score
`sharpe_ratio`	Number [ratio]	Risk-adjusted return
`sortino_ratio`	Number [ratio]	Downside risk-adjusted return
`max_drawdown`	Number [%]	Maximum portfolio drawdown
`risk_of_ruin`	Number [%]	Estimated probability of complete capital loss
`profit_factor`	Number [ratio]	Ratio of gross profit to gross loss
`profit_expectancy`	Number [USD]	Expected profit per trade
`recovery_factor`	Number [ratio]	Net profit divided by maximum drawdown

Stability Metrics

Metrics that quantify how consistent the position’s performance is over time. Object

Field	Type	Description
`winrate_stability`	Number [%]	Consistency of winrate over time
`winrate_volatility`	Number [%]	Variance of winrate over time
`pnl_stability`	Number [%]	Consistency of PnL over time
`pnl_volatility`	Number [%]	Variance of PnL over time
`roi_stability`	Number [%]	Consistency of ROI over time
`roi_volatility`	Number [%]	Variance of ROI over time

Ratio Metrics

Comparative ratios that contextualize the quality and balance of the position’s trading outcomes. Object

Field	Type	Description
`pnl_volume_ratio`	Number [ratio]	PnL relative to total volume traded
`win_loss_size_ratio`	Number [ratio]	Average winning trade size divided by average losing trade size

ROI Distribution

A histogram of outcomes grouped into ROI buckets, showing how returns are distributed. Map(ROI Bucket, Integer)

Key	Value	Description
`gt_500`	Integer	Bucket containing values of ROI greater than 500%
`200_500`	Integer	Bucket containing values of ROI between 200% and 500%
`0_200`	Integer	Bucket containing values of ROI between 0% and 200%
`neg50_0`	Integer	Bucket containing values of ROI between -50% and 0%
`lt_neg50_0`	Integer	Bucket containing values of ROI less than -50%

ROI Bucket

Discrete return-on-investment ranges used as the keys of an ROI Distribution. Enum(String)

Value	Description
`gt_500`	ROI greater than 500%
`200_500`	ROI between 200% and 500%
`0_200`	ROI between 0% and 200%
`neg50_0`	ROI between -50% and 0%
`lt_neg50_0`	ROI less than -50%

Time Window

Rolling lookback period used to scope metrics. Enum(String)

Value	Description
`30d`	Last 30 days
`14d`	Last 14 days
`7d`	Last 7 days
`3d`	Last 3 days
`1d`	Last 1 day
`12h`	Last 12 hours
`6h`	Last 6 hours
`3h`	Last 3 hours
`1h`	Last 1 hour
`30m`	Last 30 minutes
`15m`	Last 15 minutes
`5m`	Last 5 minutes
`1m`	Last 1 minute

​Wallet Profile

​Metadata

​Metrics

​Performance Metrics

​Volume Metrics

​Trade Count Metrics

​Daily Averages

​Per-Trade Averages

​Risk Metrics

​Stability Metrics

​Ratio Metrics

​Token Profile

​Metadata

​Metrics

​Volume & Trade Metrics

​Participant Metrics

​PnL Metrics

​Price Metrics

​Size Metrics

​Per-Trade Averages

​Wallet Performance Metrics

​Ratio Metrics

​Stability Metrics

​Risk Metrics

​Position Profile

​Metadata

​Metrics

​Performance Metrics

​Volume Metrics

​Trade Count Metrics

​Daily Averages

​Per-Trade Averages

​Risk Metrics

​Stability Metrics

​Ratio Metrics

​ROI Distribution

​ROI Bucket

​Time Window

Wallet Profile

Metadata

Metrics

Performance Metrics

Volume Metrics

Trade Count Metrics

Daily Averages

Per-Trade Averages

Risk Metrics

Stability Metrics

Ratio Metrics

Token Profile

Metadata

Metrics

Volume & Trade Metrics

Participant Metrics

PnL Metrics

Price Metrics

Size Metrics

Per-Trade Averages

Wallet Performance Metrics

Ratio Metrics

Stability Metrics

Risk Metrics

Position Profile

Metadata

Metrics

Performance Metrics

Volume Metrics

Trade Count Metrics

Daily Averages

Per-Trade Averages

Risk Metrics

Stability Metrics

Ratio Metrics

ROI Distribution

ROI Bucket

Time Window