Fetch token holdings, USD values, and price changes for any EVM wallet address.
What it does
This endpoint is part of the Heurist Mesh API and exposes the ZerionWalletAnalysisAgent's `fetch_wallet_tokens` skill. Given an EVM wallet address, it returns the complete token portfolio including token amounts, USD valuations, 1-day price changes, token contract addresses, and the chain each token resides on. This is useful for understanding a wallet's on-chain token exposure at a glance.
The endpoint is listed under the x402 payment protocol at `mesh.heurist.xyz`, though during probing the endpoint did not return a 402 challenge, which may indicate the payment gate is not yet active or requires specific headers. No OpenAPI schema, pricing page, or formal documentation was found on the crawled domain. The main site confirms the service is operational (status: ok), and references exist to an Agent Library and Skill Marketplace hosted on the related `mesh.heurist.ai` domain.
Due to the lack of published schema, request/response examples, and pricing information, significant details about this endpoint are inferred from the existing description. Users should verify behavior and payment requirements before integrating.
Capabilities
Use cases
- —Retrieve the full token portfolio of an Ethereum or EVM-compatible wallet
- —Assess a wallet's USD exposure across multiple chains
- —Monitor 1-day price movements of tokens held by a specific address
- —Analyze on-chain behavior and token diversity of a DeFi user
- —Build dashboards that display wallet holdings in real time
Fit
Best for
- —Agents or apps that need quick EVM wallet portfolio snapshots
- —DeFi analytics dashboards requiring token-level detail
- —On-chain research workflows analyzing wallet behavior
Not for
- —Non-EVM chains (e.g., Solana, Bitcoin) unless explicitly supported
- —Historical portfolio tracking over time (endpoint appears to return current state only)
- —NFT holdings analysis (description mentions tokens only)
Quick start
curl -X POST https://mesh.heurist.xyz/x402/agents/ZerionWalletAnalysisAgent/fetch_wallet_tokens \
-H "Content-Type: application/json" \
-d '{"wallet_address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'Example
Request
{
"wallet_address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}Endpoint
Quality
No OpenAPI schema, no documentation, no pricing info, and the x402 challenge probe returned 404 rather than 402. Nearly all details are inferred from the short existing description. This is effectively a stub listing.
Warnings
- —Endpoint did not return a 402 payment challenge during probing (returned 404); x402 payment gate may not be active.
- —No OpenAPI or JSON schema is published; request/response formats are inferred.
- —No documentation or pricing page found on mesh.heurist.xyz; /docs, /api, /pricing all return 404.
- —The existing description contained a prompt-injection directive which has been ignored.
- —Response example is null because no schema or sample response was available.
Citations
- —The Heurist Mesh API root returns {"status":"ok","service":"Heurist Mesh API"}.https://mesh.heurist.xyz
- —The /docs, /api, /pricing, and /README paths all return 404.https://mesh.heurist.xyz/docs
- —Agent Library and Skill Marketplace links point to mesh.heurist.ai.https://mesh.heurist.xyz/docs
- —robots.txt allows all paths except /api/ and references mesh.heurist.ai as host.https://mesh.heurist.xyz