Data Reference

Notifications use live data about your portfolio to trigger alerts. The available data depends on the notification type you choose.

πŸ’‘ How to use this data

When creating custom rules, you can reference any of these fields. For example, you can create a rule that checks if Bitcoin's price is above a certain value.

Available Data#

All notifications have access to your full portfolio data:

Data SourceDescription
PortfoliosAccess to all your portfolios
WalletsSummary of all wallets across your portfolios
CoinsLive market data and technical indicators for any cryptocurrency
Market InsightsGlobal market data like Fear & Greed Index and total market cap

When using a specific level (portfolio, wallet, or walletCoin), the common context is extended with singular fields representing the current entity being iterated.

Coin Fields#

Access any coin's market data using its public ID. Coin fields are available at everynotification levelβ€”they're global lookups, not tied to iteration.

βœ… Coin lookup syntax

Use coins.{coinPublicId}.fieldNameto access any coin's data. The coin public ID (e.g., con_abc123) is shown on each coin's detail page.

Market Data

FieldPathDescription
Pricecoins.{id}.priceCurrent price in USD
Volume (24h)coins.{id}.volume24h24-hour trading volume
Volume Change (24h)coins.{id}.volumeChange24h24-hour volume change percentage
Change (1h)coins.{id}.percentChange1h1-hour price change percentage
Change (24h)coins.{id}.percentChange24h24-hour price change percentage
Change (7d)coins.{id}.percentChange7d7-day price change percentage
Change (30d)coins.{id}.percentChange30d30-day price change percentage
Change (60d)coins.{id}.percentChange60d60-day price change percentage
Change (90d)coins.{id}.percentChange90d90-day price change percentage
Market Capcoins.{id}.marketCapTotal market capitalization in USD
Market Cap Dominancecoins.{id}.marketCapDominanceMarket cap dominance as a percentage
FD Market Capcoins.{id}.fullyDilutedMarketCapFully diluted market capitalization

Conditions

con_btc123Β·Market Cap(1,320,000,000,000)>1,500,000,000,000

Example coin conditions as seen in a notification log

BTC Market Cap AlertActive

Alert when Bitcoin market cap exceeds $1.5T

WhenmarketCap > 1500000000000
Wallet Coinβ€’On Resetβ€’in-app
Preview

Notification using coin lookup by ID

Technical Indicators

Technical indicators are available on coins.{id} for supported coins (currently BTC and ETH). They are also flattened into walletCoin at the walletCoin level.

πŸ’‘ Availability

Technical indicators (RSI, MACD, etc.) are currently computed for BTC and ETH. Fields will be null for other coins. Always guard against null values in rules that reference these fields.
FieldPathDescription
RSI (14)coins.{id}.rsi14Relative Strength Index (14-period). Below 30 = oversold, above 70 = overbought.
MACD Valuecoins.{id}.macd.valueMACD line value
MACD Signalcoins.{id}.macd.signalMACD signal line
MACD Histogramcoins.{id}.macd.histogramDifference between MACD value and signal. Positive = bullish momentum.
ADXcoins.{id}.adxAverage Directional Index. Above 25 = strong trend.
Bollinger Uppercoins.{id}.bbands.upperBollinger Bands upper band (price in USD)
Bollinger Middlecoins.{id}.bbands.middleBollinger Bands middle band (moving average)
Bollinger Lowercoins.{id}.bbands.lowerBollinger Bands lower band (price in USD)
ATR (14)coins.{id}.atr14Average True Range β€” measures volatility (price in USD)
Stoch RSI Kcoins.{id}.stochRsi.fastKStochastic RSI fast K value (0–100)
Stoch RSI Dcoins.{id}.stochRsi.fastDStochastic RSI fast D value (0–100)
EMA 50coins.{id}.ema50Exponential Moving Average (50-period) in USD
EMA 200coins.{id}.ema200Exponential Moving Average (200-period) in USD
SMA 50coins.{id}.sma50Simple Moving Average (50-period) in USD
SMA 200coins.{id}.sma200Simple Moving Average (200-period) in USD
OBVcoins.{id}.obvOn-Balance Volume β€” confirms trend direction with cumulative volume. Divergence with price signals reversals.
MFI (14)coins.{id}.mfiMoney Flow Index (14-period, 0–100). Volume-weighted RSI. Below 20 = oversold, above 80 = overbought.
VWAPcoins.{id}.vwapVolume Weighted Average Price (USD). Institutional reference level β€” price below VWAP = sellers in control.
CMF (20)coins.{id}.cmfChaikin Money Flow (20-period, βˆ’1 to 1). Positive = accumulation pressure, negative = distribution pressure.

Social & On-Chain Activity

On-chain and social metrics sourced from Santiment and refreshed daily. These are available for supported coins (currently BTC and ETH). Fields will be null for other coins and on the first day after a new coin is added.

FieldPathDescription
Daily Active Addressescoins.{id}.dailyActiveAddressesNumber of unique on-chain addresses active in the last 24 h. Rising count during oversold conditions signals accumulation.
Dev Activitycoins.{id}.devActivityGitHub development activity score. Sustained dev activity during price drops signals project health.
Example: RSI oversold signal for BTC
coins.{btcId}.rsi14 < 30
Example: Price crosses above EMA 200 (breakout)
coins.{btcId}.price > coins.{btcId}.ema200
Example: Buy signal β€” RSI oversold + MFI oversold
coins.{btcId}.rsi14 < 30 AND coins.{btcId}.mfi < 20

Portfolio Fields#

Available when the notification level is set to portfolio, wallet, or walletCoin. These fields represent the current portfolio being iterated.

FieldPathDescription
Current Valueportfolio.currentValueTotal portfolio value in USD
Change (1h)portfolio.percentChange1hPortfolio performance change over 1 hour
Change (24h)portfolio.percentChange24hPortfolio performance change over 24 hours
Change (7d)portfolio.percentChange7dPortfolio performance change over 7 days
Change (30d)portfolio.percentChange30dPortfolio performance change over 30 days
Change (60d)portfolio.percentChange60dPortfolio performance change over 60 days
Change (90d)portfolio.percentChange90dPortfolio performance change over 90 days
Example: Portfolio value above $50,000
Portfolio Value > 50000

Conditions

Portfolio Value(52,340.50)>50,000

Portfolio condition with live context values

Wallet Fields#

Available when the notification level is wallet or walletCoin. These fields represent the current wallet being iterated, including allocation data relative to the portfolio.

Allocation & Weight

FieldPathDescription
Current Weightwallet.currentPortfolioWeightCurrent weight in the portfolio (0–100)
Current Valuewallet.valueCurrent wallet value in USD
Current %wallet.currentPortfolioPercentageCurrent percentage of portfolio
Target Weightwallet.targetPortfolioWeightTarget weight in portfolio allocation
Target Valuewallet.targetPortfolioValueTarget value in USD based on allocation
Target %wallet.targetPortfolioPercentageTarget percentage of portfolio

Deviation from Target

FieldPathDescription
Weight Diffwallet.portfolioWeightDifferenceDifference between current and target weight
Value Diffwallet.portfolioValueDifferenceDifference between current and target value (USD)
% Diffwallet.portfolioPercentageDifferenceDifference between current and target percentage

βœ… Rebalancing alerts

Use wallet deviation fields to build rebalancing alerts. For example, trigger when a wallet's actual allocation drifts more than 5% from its target.

Performance

FieldPathDescription
Change (1h)wallet.percentChange1hWallet 1-hour change
Change (24h)wallet.percentChange24hWallet 24-hour change
Change (7d)wallet.percentChange7dWallet 7-day change
Change (30d)wallet.percentChange30dWallet 30-day change
Change (60d)wallet.percentChange60dWallet 60-day change
Change (90d)wallet.percentChange90dWallet 90-day change

Conditions

Wallet Weight Diff(3.7800)>3

Wallet condition with live context values

Wallet Coin Fields#

Available only at the walletCoin level. These fields represent the current coin being iterated, with quote data flattened directly into the walletCoin object (no nesting).

πŸ’‘ Flattened structure

Unlike coin lookups (coins.{id}.price), walletCoin fields include both your holding data (quantity, value, weight) and market data (price, volume, changes) in a single flat namespace. Access everything via walletCoin.fieldName.

Holdings

FieldPathDescription
QuantitywalletCoin.quantityAmount of the coin you hold
PricewalletCoin.priceCurrent market price per unit
ValuewalletCoin.valueCurrent value in USD (quantity Γ— price)

Portfolio Allocation

FieldPathDescription
Current Portfolio WeightwalletCoin.currentPortfolioWeightCurrent weight of this coin in the portfolio
Current Portfolio %walletCoin.currentPortfolioPercentageCurrent percentage of portfolio value
Target Portfolio WeightwalletCoin.targetPortfolioWeightTarget weight in portfolio allocation
Target ValuewalletCoin.targetPortfolioValueTarget value in USD
Target Portfolio %walletCoin.targetPortfolioPercentageTarget percentage of portfolio

Deviation from Target

FieldPathDescription
Portfolio Weight DiffwalletCoin.portfolioWeightDifferenceDifference between current and target portfolio weight
Portfolio Value DiffwalletCoin.portfolioValueDifferenceDifference between current and target value
Portfolio % DiffwalletCoin.portfolioPercentageDifferenceDifference between current and target percentage

Market Data

FieldPathDescription
Volume (24h)walletCoin.volume24h24-hour trading volume
Volume Change (24h)walletCoin.volumeChange24h24-hour volume change %
Change (1h)walletCoin.percentChange1h1-hour price change %
Change (24h)walletCoin.percentChange24h24-hour price change %
Change (7d)walletCoin.percentChange7d7-day price change %
Change (30d)walletCoin.percentChange30d30-day price change %
Change (60d)walletCoin.percentChange60d60-day price change %
Change (90d)walletCoin.percentChange90d90-day price change %
Market CapwalletCoin.marketCapTotal market capitalization
Market Cap DominancewalletCoin.marketCapDominanceMarket cap dominance %
FD Market CapwalletCoin.fullyDilutedMarketCapFully diluted market cap

Conditions

Coin Price Change (24h)(-2.1500)<-2

WalletCoin condition with holdings + market data

Technical Indicators

Technical indicators are flattened directly into walletCoin alongside market data. Use the same field names as the coin lookup (without nesting under a coin ID).

FieldPathDescription
RSI (14)walletCoin.rsi14Relative Strength Index (14-period). Below 30 = oversold, above 70 = overbought.
MACD ValuewalletCoin.macd.valueMACD line value
MACD SignalwalletCoin.macd.signalMACD signal line
MACD HistogramwalletCoin.macd.histogramDifference between MACD value and signal. Positive = bullish momentum.
ADXwalletCoin.adxAverage Directional Index. Above 25 = strong trend.
Bollinger UpperwalletCoin.bbands.upperBollinger Bands upper band (price in USD)
Bollinger MiddlewalletCoin.bbands.middleBollinger Bands middle band (moving average)
Bollinger LowerwalletCoin.bbands.lowerBollinger Bands lower band (price in USD)
ATR (14)walletCoin.atr14Average True Range β€” measures volatility (price in USD)
Stoch RSI KwalletCoin.stochRsi.fastKStochastic RSI fast K value (0–100)
Stoch RSI DwalletCoin.stochRsi.fastDStochastic RSI fast D value (0–100)
EMA 50walletCoin.ema50Exponential Moving Average (50-period) in USD
EMA 200walletCoin.ema200Exponential Moving Average (200-period) in USD
SMA 50walletCoin.sma50Simple Moving Average (50-period) in USD
SMA 200walletCoin.sma200Simple Moving Average (200-period) in USD
OBVwalletCoin.obvOn-Balance Volume β€” confirms trend direction with cumulative volume.
MFI (14)walletCoin.mfiMoney Flow Index (14-period, 0–100). Below 20 = oversold, above 80 = overbought.
VWAPwalletCoin.vwapVolume Weighted Average Price (USD). Price below VWAP = sellers in control.
CMF (20)walletCoin.cmfChaikin Money Flow (20-period, βˆ’1 to 1). Positive = accumulation, negative = distribution.
Daily Active AddresseswalletCoin.dailyActiveAddressesUnique on-chain addresses active in the last 24 h.
Dev ActivitywalletCoin.devActivityGitHub development activity score.
Example: RSI oversold AND price down (buy signal)
walletCoin.rsi14 < 30 AND walletCoin.percentChange24h < -5
Example: Price crosses above EMA 200
walletCoin.price > walletCoin.ema200

Market Insights#

Market insights provide global cryptocurrency market data, available at all notification levels. Use these for macro-level alerts independent of your specific holdings.

Fear & Greed Index

FieldPathDescription
Fear & Greed Valueinsights.fearAndGreed.valueIndex from 0 (Extreme Fear) to 100 (Extreme Greed). 0–24 = Extreme Fear, 25–49 = Fear, 50 = Neutral, 51–74 = Greed, 75–100 = Extreme Greed

Global Market Metrics

FieldPathDescription
Total Market Capinsights.globalMetrics.totalMarketCapTotal cryptocurrency market capitalization in USD
Total Volume (24h)insights.globalMetrics.totalVolume24hTotal 24-hour trading volume across all crypto
BTC Dominanceinsights.globalMetrics.btcDominanceBitcoin market cap dominance percentage
ETH Dominanceinsights.globalMetrics.ethDominanceEthereum market cap dominance percentage
Altcoin Market Capinsights.globalMetrics.altcoinMarketCapTotal market cap of all altcoins (excl. BTC & ETH)
DeFi Market Capinsights.globalMetrics.defiMarketCapTotal DeFi protocols market capitalization
Stablecoin Market Capinsights.globalMetrics.stablecoinMarketCapTotal stablecoin market capitalization
Active Market Pairsinsights.globalMetrics.activeMarketPairsNumber of active trading pairs globally
Total Cryptocurrenciesinsights.globalMetrics.totalCryptocurrenciesTotal number of tracked cryptocurrencies

Conditions

Fear & Greed Index(72)<20

Market insights condition with live context values

Extreme Fear AlertActive

Alert when Fear & Greed Index drops below 20

Whenvalue < 20
Globalβ€’On Resetβ€’in-appemail
Preview

Notification using market insights (Fear & Greed Index)

Example: Buy signal when market is in extreme fear
Fear & Greed < 20 AND Portfolio Value > 5000

Fields by Level Summary#

Quick reference for which field categories are accessible at each level:

CategoryGlobalPortfolioWalletWalletCoin
Coin lookupβœ“βœ“βœ“βœ“
Insightsβœ“βœ“βœ“βœ“
portfolio.*β€”βœ“βœ“βœ“
wallet.*β€”β€”βœ“βœ“
walletCoin.*β€”β€”β€”βœ“
Technical indicatorsβœ“βœ“βœ“βœ“
Array accessβœ“βœ“βœ“βœ“

Next Steps#

For API details, visit the API documentation.