Retrieve wallet token balances on Base via x402-paid POST endpoint.
What it does
This x402-gated endpoint, operated by Erudite Intelligence LLC, returns token balance data for a given wallet or contract address on the Base network. You send a POST request with a JSON body containing an `address` field (an Ethereum-style wallet or contract address), and the endpoint returns balance information as JSON.
Payment is required per-call via the x402 protocol. The endpoint accepts two payment options: USDC on Base (eip155:8453) at 0.01 USDC per request, or USDT on Tron at 0.01 USDT per request. The x402 challenge is facilitated through Coinbase CDP (for Base) or directly on Tron. The provider describes the service category as "Crypto data intelligence."
The response schema is minimal — the example output shows `{"success": true, "data": {}}` — so the exact structure of the returned balance data is not fully documented. No OpenAPI spec or dedicated documentation page is available (the /docs path returns a 404). The endpoint is live and returns a valid x402 v2 challenge. The facilitator bridge (bridge.eruditepay.com) supports 20 blockchains for payment settlement and is registered as a FinCEN MSB.
Capabilities
Use cases
- —Querying token balances for a wallet address on Base before executing a trade or transfer
- —Building portfolio dashboards that display real-time wallet holdings
- —Automated agents checking wallet balances as part of DeFi workflows
- —Verifying wallet funding status before initiating on-chain transactions
Fit
Best for
- —AI agents needing on-demand wallet balance data with pay-per-call pricing
- —Developers building crypto portfolio tools on Base
- —Automated workflows that need to verify wallet balances without running a full node
Not for
- —Historical balance queries or time-series balance data (no evidence of support)
- —Querying balances on chains other than Base (this specific endpoint is Base-scoped)
- —Free or high-volume bulk balance lookups (each call costs 0.01 USD)
Quick start
curl -X POST https://bridge.eruditepay.com/v1/base/wallet/balances \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_header>" \
-d '{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'Example
Request
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}Response
{
"data": {},
"success": true
}Endpoint
Quality
The endpoint is live and returns a valid x402 v2 challenge with clear pricing and a basic schema. However, documentation is absent (/docs returns 404), the output example is a stub with an empty data object, and there is no OpenAPI spec. The actual structure of balance data returned is unknown.
Warnings
- —No dedicated documentation available — /docs, /api, /pricing, and /README all return 404.
- —The example output shows an empty data object; the actual response structure for balance data is undocumented.
- —Only the Bazaar extension schema is available; no OpenAPI or detailed field descriptions exist.
Citations
- —Endpoint returns x402 v2 challenge with USDC on Base at amount 10000 (0.01 USDC) and USDT on Tron at amount 10000 (0.01 USDT)https://bridge.eruditepay.com/v1/base/wallet/balances
- —Provider is Erudite Intelligence LLC, FinCEN MSB registered with BSA ID 31000324258137https://bridge.eruditepay.com
- —The facilitator bridge supports 20 blockchains and charges 0.5% per settlementhttps://bridge.eruditepay.com
- —x402 facilitator for Base payments is Coinbase CDP at https://api.cdp.coinbase.com/platform/v2/x402https://bridge.eruditepay.com/v1/base/wallet/balances