78trust / 100

Wallet Balance Lookup

by api.strale.io in Onchain & crypto

x402 APIPassing, checked 2 h ago

Get a wallet's native balance and the ERC-20 tokens it most recently sent or received, on Ethereum, Base, Arbitrum, Optimism or Polygon.

GET https://api.strale.io/x402/wallet-balance-lookup

Last 30 days

All checks passedSome failedAll failedNot checked

Status and outage history · Atom feed

Uptime
100%
Response time
141 ms typical, 369 ms slowest 5%
Last check
2 h ago
Next check
any minute now

How to call it

GET https://api.strale.io/x402/wallet-balance-lookup

Each call costs $0.0216 in USDC on Base, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

Built from the input schema. Replace the values with your own.

GET https://api.strale.io/x402/wallet-balance-lookup?address=example

Parameters

ParameterTypeRequiredDescription
addressstringYesWallet address (0x...)
chain_idstringNoChain ID: 1 (Ethereum), 8453 (Base), 42161 (Arbitrum One), 10 (OP Mainnet) or 137 (Polygon PoS). Default: 1

Example response

The listing has no example response.

Call it from code

The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.0216.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://api.strale.io/x402/wallet-balance-lookup?address=example'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://api.strale.io/x402/wallet-balance-lookup?address=example' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode
JavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.0216 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.0216" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.0216 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.strale.io%2Fx402%2Fwallet-balance-lookup
const res = await pay("https://api.strale.io/x402/wallet-balance-lookup?address=example");
console.log(res.status, await res.text());
Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.0216 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.0216"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://api.strale.io/x402/wallet-balance-lookup?address=example")
    print(res.status_code, res.text)

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
2 h agoPassed402369 ms$0.022
6 h agoPassed402308 ms$0.022
10 h agoPassed402283 ms$0.022
14 h agoPassed402130 ms$0.022
18 h agoPassed402284 ms$0.022
22 h agoPassed402371 ms$0.022
26 h agoPassed402137 ms$0.022
30 h agoPassed402133 ms$0.022
33 h agoPassed402268 ms$0.022
37 h agoPassed402134 ms$0.022
40 h agoPassed402141 ms$0.022
44 h agoPassed402303 ms$0.022
47 h agoPassed402122 ms$0.022
2 days agoPassed402293 ms$0.022
2 days agoPassed402134 ms$0.022