Crypto Wallet PnL API - Allium Token Prices and Balances

Export crypto wallet PnL, token balances, decoded transactions, token transfers, USD holdings history and DEX-derived token prices from the Allium Realtime APIs into an Apify dataset with your own Allium API key.

Works with the Allium Realtime (Developer) APIs at api.allium.so. Give the actor a list of tokens or wallets as chain:address lines and it returns clean, deduplicated rows you can download as JSON, CSV or Excel, schedule, or feed into portfolio trackers, tax and accounting tools, trading dashboards, research notebooks and AI agents. Bring your own key.

What it does

• Wallet PnL: realized and unrealized profit and loss for a wallet, its total USD balance, and per-token average cost, using the average cost basis method. Solana, Bitcoin, Ethereum, Base, Arbitrum and 11 more chains.
• Wallet PnL by token: PnL for one wallet and one token, with the trade history (amount, price, time) behind its average cost.
• Latest wallet balances: every fungible token a wallet holds, scaled by decimals, with USD price, USD value and optional DEX liquidity to filter spam tokens.
• Historical wallet balances: each balance change of a wallet over a time range, block by block.
• Wallet holdings history: the USD value of a wallet over time at 15 second to 1 day intervals, optionally broken down per token.
• Wallet transactions: decoded transactions with asset transfers, labels and activities (DEX trades, NFT trades, approvals, bridges, liquidity pool mints and burns).
• Wallet token transfers: fungible token transfers sent or received by a wallet, filtered by token and time range.
• Latest token price, price history, price stats and price at a timestamp: USD prices computed from on-chain DEX trades with outlier filtering, OHLC candles from 15 seconds to 1 day, 24h and 1h high, low and percent change.
• Top tokens, token search and token details: rank tokens by volume, trade count or fully diluted valuation, search by name or symbol, and read supply, FDV, volume, holders count, all-time high and low.
• Pay only for results: a token or wallet Allium returns nothing for, and any refused request, is recorded as a free row that says why.

How to get an API key

Create an account at app.allium.so/join, log in, and generate a key under Settings > API Keys (one key per user). Allium plans are sold through its sales team and the Realtime APIs must be included in yours. Paste the key into the API key field or set the DATA_API_KEY environment secret. This actor never ships a shared key.

Input

Field	Used by	What it does
mode	all	latestPrice, priceHistory, priceStats, priceAtTimestamp, listTokens, searchTokens, tokenDetails, tokenTransfers, walletTransactions, walletBalances, balanceHistory, holdingsHistory, walletPnl or walletTokenPnl
tokens	token modes	chain:address per line, such as ethereum:0xa0b8...eb48 or solana:So111...112; an address alone uses the default chain
wallets	wallet modes	chain:address per line
walletTokens	PnL by token	chain:wallet:token per line
chain	all	Default chain for lines without one, and the chain for top tokens and search (default ethereum)
searchQuery, allChains	search, top tokens	Name or symbol to search; rank or search across every chain
sortBy, sortGranularity, sortOrder	search, top tokens	Volume, trade count or FDV; last day or hour; highest or lowest first
minVolumeUsd1d, minVolumeUsd1h	search, top tokens	Minimum USD volume
startTime, endTime	price history, balance history, holdings, transfers	ISO time, date, or lookback such as 24h or 30d (default last 7 days)
timeGranularity	price history, price at timestamp, holdings	15s, 1m, 5m, 1h (default) or 1d
atTimestamp, stalenessTolerance	price at timestamp	The moment to price at; the furthest lookback such as 1h
withLiquidityInfo	latest price, balances	Add total DEX liquidity in USD per token
minLiquidityUsd	PnL, holdings	Leave out tokens below this liquidity
includeTokenBreakdown	holdings	Per-token USD value at every interval
activityType, transactionHash	transactions	Only one decoded activity type; only one transaction
transferType, transferToken, sortDirection	transfers	Sent, received or both; one token; newest or oldest first
maxResults	all	Row ceiling for the run (default 100, up to 10,000)
requestsPerMinute	all	Pacing to your plan's rate limit (default 60)
apiKey	all	Your Allium API key (secret), or set DATA_API_KEY

Chain coverage differs by endpoint (Allium's published list, October 2026): prices on 13 chains (Ethereum, Solana, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, Celo, Unichain, zkSync, HyperEVM, Robinhood); balances and transactions on 19 (adds Bitcoin, NEAR, Stellar, Monad, X Layer, XDC, Arc); PnL on 16; token lists and search on 12 (adds Bitcoin, Dogecoin and Stellar).

Example output

{
    "mode": "walletBalances",
    "recordType": "balance",
    "identifier": "ethereum:0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "found": true,
    "chain": "ethereum",
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "symbol": "USDC",
    "name": "USD Coin",
    "priceUsd": 0.9999,
    "amount": 123.456789,
    "valueUsd": 123.4444,
    "timestamp": "2026-10-01T00:00:00Z",
    "transactionHash": null,
    "note": null,
    "rawBalance": "123456789",
    "decimals": 6,
    "tokenType": "evm_erc20",
    "blockNumber": 23500000,
    "totalLiquidityUsd": "LIQUIDITY_TOO_HIGH",
    "retrievedAt": "2026-10-12T12:00:00.000Z"
}

A wallet PnL row adds realizedPnlUsd, unrealizedPnlUsd, unrealizedPnlRatioChange, tokenCount and a tokens list with each token's average cost, current price and PnL. A transaction row adds activityTypes, labels, assetTransfers and activities. A price candle adds open, high, low, close and granularity.

FAQ

What is Allium?

Allium is an enterprise blockchain data platform. Its Realtime APIs serve token prices, wallet balances, transactions, holdings and PnL across 20+ chains with a few seconds of freshness, and power wallets such as Phantom. This actor calls those APIs with your key.

How does Allium calculate wallet PnL?

With the average cost basis method: buys reweight the average cost, sells keep it, and unrealized PnL is the current balance times the current price minus the average cost. Realized PnL accrues at each sale.

Where do Allium token prices come from?

From on-chain DEX trades, converted to USD against known tokens, built into candles and returned as a volume-weighted average price, with z-score outlier filtering against arbitrage spikes. A token with no trade in the last 7 days returns no latest price.

Which chains does it support?

Ethereum, Solana, Base, Arbitrum, Optimism, Polygon, BNB Smart Chain, Avalanche, Bitcoin, Unichain, zkSync, Celo, HyperEVM, Monad, Robinhood Chain, X Layer, XDC Network, Arc, NEAR, Stellar and Dogecoin, with coverage per endpoint as listed under Input.

How do I filter spam tokens out of balances and PnL?

Turn on withLiquidityInfo for balances and prices, then drop rows whose totalLiquidityUsd is a small number; or set minLiquidityUsd for PnL and holdings history so Allium leaves low-liquidity tokens out of the totals.

Why did a wallet or token come back as a row with found set to false?

Allium answered nothing for it (no trades, no holdings, an unsupported chain for that endpoint) or refused the request. The note says which, and the row is not charged.

Can I use Allium Explorer SQL queries with this actor?

No. The Explorer API is enterprise-only and is not wired here; this actor covers the Realtime APIs.

Pricing

Pay per event, only for rows that carry data:

• Token or balance row: $0.005 (prices, candles, stats, tokens, transfers, balances, holdings snapshots)
• Decoded wallet transaction: $0.01
• Wallet PnL row: $0.015 (by wallet, or by wallet and token)

Empty lookups and refusals are free. Allium bills your own account separately under your Allium plan.

Terms

Allium's terms limit use of its service and data to the customer's internal business and forbid redistributing or reselling the data. The rows this actor returns belong to your own Allium account and are for your own use; check your Allium order before sharing them.

Keyword map

crypto wallet PnL API, wallet profit and loss, token price API, DEX token prices, OHLC crypto candles, wallet token balances, historical wallet balances, portfolio value history, decoded wallet transactions, ERC20 transfers, Solana token prices, Allium API, Allium Realtime API, blockchain data API.

BYOK, not live-tested: the routes were checked against Allium's docs and its route table, but no run used a real Allium key.