Tokens & balances
Resolve addresses, display metadata and keep market data separate from execution.
Resolve by contract address
curl "https://api.pathagg.xyz/api/v1/tokens?address=0xb88339cb7199b77e23db6e890353e22632ba630f"
curl "https://api.pathagg.xyz/api/v1/tokens/search?q=HYPE"Metadata comes from curated entries or onchain contract reads. Search supports names, symbols, quoted exact matches and addresses. Unknown tokens are validated on HyperEVM; a matching symbol alone is never enough to establish identity.
Amounts in requests and responses are base-unit integer strings. Read decimals for each token. Do not pass a JavaScript floating-point number to represent token balances or raw swap amounts.
Logos and indicative prices
DexScreener provides display images and indicative USD market data for HyperEVM pairs. HYPE, WHYPE, USDC and USD₮0 use Path’s supplied logo assets. Missing images fall back to initials. An image is associated with its exact token address, never copied from another asset sharing a pool or symbol.
Trending is a bounded ranking by reported 24-hour volume in the returned WHYPE pools, not a chain-wide leaderboard. Display prices older than 90 seconds are omitted. These prices do not build swap transactions and do not trigger Limit orders.
Wallet holdings and balances
| Endpoint | Scope |
|---|---|
| POST /api/v1/tokens/holdings | Body: {account}. Candidate discovery from recent ERC20 transfers plus starter tokens. |
| POST /api/v1/tokens/balances | Body: {account, tokens}. Up to 40 native/ERC20 balance reads. |
Holdings discovery uses Etherscan transfer history and remains incomplete: complete is always false. Candidates need current onchain balances. Failed balance reads return null rather than a fabricated zero. Token metadata and logos are not a safety endorsement.