Use when you need a crypto token price or market data for a Base token, quoted f
Use when you need a crypto token price or market data for a Base token, quoted from on-chain liquidity. Do not use for tokens that only trade off Base or on other DEXs (Aerodrome is not read), price history or OHLC. Returns JSON with the USD price of a token on Base computed on-chain from its deepest Uniswap v3 pool against USDC or WETH, with pool, fee tier and depth for 0.003 USDC per call. Typical response time 1200 ms (p95). Category: Trading.
Answeringour last check, 2026-10-18
1 of 1checks answered this week
2229 msmedian answer time
$0.003listed price per call
$0.003price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://x402-gateway.blackwoodstate8.workers.dev/v1/token-price
| Category | Market data |
|---|---|
| Provider host | x402-gateway.blackwoodstate8.workers.dev |
| Networks | eip155:8453 |
| Payment schemes | exact, upto |
| Self-reported calls, 30 days | 4 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-18 | valid payment request | 402 | $0.003 | 2229 ms |
Example input (from the provider)
{
"body": {
"token": "WETH"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"token": {
"description": "Token on Base: contract address (0x...) or a symbol like WETH, cbBTC, AERO, DEGEN, VIRTUAL",
"maxLength": 42,
"minLength": 2,
"type": "string"
}
},
"required": [
"token"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"additionalProperties": false,
"properties": {
"blockNumber": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"decimals": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"depthUsd": {
"type": [
"number",
"null"
]
},
"feeTier": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"next": {
"additionalProperties": false,
"description": "Suggested next paid call in the same family (call it in a loop when the task continues)",
"properties": {
"method": {
"enum": [
"GET",
"POST"
],
"type": "string"
},
"sample": {
"description": "Free fixed sample of the whole family",
"type": "string"
},
"service": {
"description": "Service id of the suggested next paid call",
"type": "string"
},
"tool": {
"description": "MCP tool name of the same call",
"type": "string"
},
"url": {
"description": "Paid route of the next call",
"type": "string"
},
"useWhen": {
"description": "When the next call is the right one",
"type": "string"
}
},
"required": [
"service",
"tool",
"method",
"url",
"useWhen",
"sample"
],
"type": "object"
},
"pool": {
"type": [
"string",
"null"
]
},
"priceUsd": {
"type": "number"
},
"quote": {
"enum": [
"USDC",
"WETH"
],
"type": "string"
},
"source": {
"type": "string"
},
"symbol": {
"type": [
"string",
"null"
]
},
"token": {
"type": "string"
}
},
"required": [
"token",
"symbol",
"decimals",
"priceUsd",
"quote",
"pool",
"feeTier",
"depthUsd",
"blockNumber",
"source"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}