Use when you need a multi-chain wallet balance, a wallet portfolio or the recent
Use when you need a multi-chain wallet balance, a wallet portfolio or the recent transaction history of an address on Ethereum, Base or Solana. Do not use for uSD values, NFTs, DeFi positions, long-tail tokens or chains beyond Ethereum, Base and Solana. Returns JSON with a wallet's native and major-token balances on Ethereum, Base or Solana plus its latest transfers in and out, in one call, leaving airdrop spam out for 0.005 USDC per call. Typical response time 3000 ms (p95). Category: Data.
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/wallet-portfolio
| Category | Market data |
|---|---|
| Provider host | x402-gateway.blackwoodstate8.workers.dev |
| Networks | eip155:8453 |
| Payment schemes | exact, upto |
| Self-reported calls, 30 days | 3 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
We never call tools that send, buy, move money or file anything, not even without paying.
Example input (from the provider)
{
"body": {
"address": "0xFf918CFB0690FdEd4224DBDab916F6E6F78882b7",
"chains": [
"base"
],
"historyLimit": 2
},
"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": {
"address": {
"description": "Wallet address: 0x... for Ethereum and Base, or a Solana address, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"maxLength": 44,
"minLength": 32,
"type": "string"
},
"chains": {
"description": "Chains to read (ethereum and base for a 0x address, solana for a Solana address, when omitted), e.g. [\"base\"]",
"items": {
"enum": [
"ethereum",
"base",
"solana"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
},
"historyLimit": {
"description": "Latest transfers to return per chain, 0 to 25 (10 when omitted), e.g. 5",
"maximum": 25,
"minimum": 0,
"type": "integer"
}
},
"required": [
"address"
],
"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": {
"address": {
"type": "string"
},
"base": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"history": {
"items": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"asset": {
"type": "string"
},
"counterparty": {
"type": [
"string",
"null"
]
},
"direction": {
"enum": [
"in",
"out",
"self"
],
"type": "string"
},
"hash": {
"type": "string"
},
"time": {
"type": [
"string",
"null"
]
}
},
"required": [
"hash",
"time",
"direction",
"counterparty",
"asset",
"amount"
],
"type": "object"
},
"type": "array"
},
"native": {
"additionalProperties": false,
"properties": {
"balance": {
"type": "string"
},
"symbol": {
"type": "string"
}
},
"required": [
"symbol",
"balance"
],
"type": "object"
},
"tokens": {
"items": {
"additionalProperties": false,
"properties": {
"balance": {
"type": "string"
},
"contract": {
"type": "string"
},
"decimals": {
"type": "number"
},
"symbol": {
"type": "string"
}
},
"required": [
"symbol",
"contract",
"decimals",
"balance"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"native",
"tokens",
"history"
],
"type": "object"
},
{
"type": "null"
}
]
},
"ethereum": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"history": {
"items": {
"additionalProperties": false,
"properties": {
"amount": {