check_address_poisoning
chainpeek: Check a transfer recipient for address poisoning: lookalikes in the sender's history. For balance, gas and blacklist checks too use transfer_preflight; for OFAC use check_sanctions. Returns a risk (high | medium | low) for paying to: reads from's transfers of one token (default USDC) over the last 24 hours by default (about 27 minutes on Base) and finds addresses with to's first 4 and last 4 hex characters; each reason carries its evidence (tx hash, block, amount, direction). High: to was never paid and imitates an address from paid or a contact, or appears only in zero-value or dust transfers. Medium: a lookalike exists but to was paid or is a contact. Older history, other tokens and other lookalikes are not seen. Bad input is a 422, a failed read a 502 (neither charged). Typically 0.5-4 s. Price: USD 0.002. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/address-poisoning-check-api.html
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chain": "<chain>",
"from": "<from>",
"to": "<to>"
},
"name": "check_address_poisoning"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | The recipient about to be paid; must differ from `from`. | |
| from | Yes | The sending wallet whose transfer history is read. | |
| chain | Yes | ethereum, base or robinhood (Robinhood Chain, chain id 4663). | |
| token | No | Only this token's transfers are read; on robinhood pass a contract address. | USDC |
| contacts | No | Addresses you trust; `to` is compared with them too, with no chain read. | |
| lookback_s | No | Seconds of history to read (default 24 hours; public nodes serve only about 27 minutes on Base). Not with `lookback_blocks`. | |
| dust_threshold | No | Incoming transfers below this many token units are dust: default 0.01 for USDC and USDT, else off; 0 turns it off. | |
| lookback_blocks | No | Instead of `lookback_s`: the latest blocks to read; 0 checks `contacts` only. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| from | No | ||
| risk | No | ||
| chain | No | ||
| error | No | Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object. | |
| rules | No | ||
| token | No | ||
| limits | No | ||
| history | No | ||
| matches | No | ||
| reasons | No | ||
| decimals | No | ||
| rpc_calls | No | ||
| to_history | No | ||
| token_symbol | No | ||
| matches_total | No | ||
| dust_threshold | No | ||
| contacts_checked | No | ||
| dust_threshold_raw | No |