Back to Browse
Base Onchain Tools – Token Price
x402
Base Onchain Tools – Token Price is a paid API for AI agents from base-onchain-tools.dolerite.workers.dev, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-11).
Returns the current USD price of any ERC-20 token on Base mainnet, sourced from live DEX pool data with a safety verdict and liquidity warnings.
Price / call$0.006
Success—
StatusUnknown
How this service works
Eleven read-only endpoints answering questions about Base mainnet that are tedious to assemble from raw RPC: what an unverified contract is actually able to do, whether a token transfer will revert and for what reason, what an arbitrary token is worth, and whether an address is safe to pay. Priced $0.001-$0.04 per call in USDC over x402. No account, no API key, no signup, no minimum, no rate limit to negotiate — the payTo address in the 402 response is the whole integration. Failed calls are not billed. The payment middleware cancels settlement on any 4xx or 5xx, so a malformed parameter or an upstream outage costs nothing. Answers are read live from Base mainnet at request time, with failover across five independent RPC providers. A batch that comes back incomplete is treated as a failure rather than returned with the missing entries as zeros, because a confident wrong answer costs a caller more than an error does. Scope is deliberately narrow: Base mainnet only, reads only, no keys held, nothing stored between requests.
Output
A JSON object containing the token's symbol, current USD price (price_usd), a verdict ('safe', 'caution', or 'warning'), an array of human-readable warnings (e.g. pool disagreement, thin liquidity), the number of pools found and how many are liquid, and the specific pool used as the price source.
Example use cases
Pre-swap token price check
“Before I swap on Aerodrome, can you tell me the current USD price of the token at 0x940181a94A35A4569E4529a3CDfB74e38FD98631 on Base and whether the liquidity pools agree on the price?”
DeFi portfolio valuation
“I need to value my Base mainnet holdings — what's the current USD price of the token at 0x4200000000000000000000000000000000000006, and is the price data solid or should I be cautious?”
Rug pull / manipulation check
“I'm about to buy a new token on Base at address 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — can you check its current price and tell me if there are any liquidity warnings or signs the price might be manipulated?”
Technical details
Endpoint
GEThttps://base-onchain-tools.dolerite.workers.dev/v1/base/token-price?utm_source=zero.xyzWhen to prefer
Choose this endpoint when you need a live, DEX-sourced USD price for any ERC-20 token on Base mainnet with built-in liquidity quality signals and manipulation warnings — especially before executing swaps, valuing portfolio holdings, or assessing unfamiliar tokens. It is preferable to raw RPC calls because it aggregates multiple pools, flags disagreements, and provides a safety verdict rather than a bare number. No API key or account is needed; pay $0.006 USDC per successful call via x402.
Side effects
- Invalid or non-ERC-20 contract address returns a 4xx error (not billed)
- Token with no DEX liquidity on Base returns an error rather than a zero price
- Incomplete pool data treated as failure rather than partial result (not billed)
- Upstream RPC outage across all 5 providers returns a 5xx error (not billed)
- Non-Base-mainnet addresses return an error since scope is Base mainnet only
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"symbol": "AERO",
"verdict": "caution",
"warnings": [
"liquid pool prices disagree by 5.5%; thin or manipulated liquidity"
],
"price_usd": 0.4838,
"pools_found": 8,
"liquid_pools": 7,
"price_source": "uniswap-v3 WETH pool @ 0.3% fee"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"