---
title: "Wallet Guard: Checks a swap or a send before you sign it."
method: POST
path: "/agents/wallet-guard"
tags: ["Agents"]
---

# Wallet Guard: Checks a swap or a send before you sign it.

`POST /agents/wallet-guard`

## Request

- Base URL: `https://coingraph.ai/api/v1`
- URL: `https://coingraph.ai/api/v1/agents/wallet-guard`
- Auth: none declared

Before a swap, it checks the token: contract risks (honeypot, taxes, mint/freeze/blacklist powers), the real price impact of the amount, holder concentration and market conditions. Before a send, it checks the recipient live on the chain: OFAC sanctions, scam and phishing flags, burn addresses, brand-new wallets and lookalikes of known addresses (address poisoning). Returns SAFE, WARN or STOP with one plain sentence for the user. Verdicts: SAFE / WARN / STOP. Price: 5 tADA on testnet (premium).

## Request body

- object
  - `token` string: The token being swapped into or sent
  - `amount_usd` number: Amount in USD
  - `to_address` string: Recipient address (for a send)
  - `chain` 'eth' | 'bsc' | 'btc' | 'sol' | 'ada': Chain of the recipient address

## Response `201`

Agent run

- object
  - `object` 'agent_run', required
  - `id` string, nullable
  - `as_of` string, date-time, required
  - `data` AgentRun, required
    - `run_id` string
    - `agent` string
    - `verdict` string
    - `summary` string
    - `result` object
    - `reasons` unknown[]
      - unknown
    - `warnings` unknown[]
      - unknown
    - `hash` string
    - `verify_url` string
  - `sources` Source[], required
    - `provider` string
    - `endpoint` string
    - `as_of` string, date-time, nullable

## Other responses

- `400`: Error
- `402`: Error
- `404`: Error
- `429`: Error

---

[API](https://skmtc.dev/coingraph/apis/coingraph-api.md) · [All operations](https://skmtc.dev/coingraph/apis/coingraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coingraph/apis/coingraph-api/revisions/55d33f7ec7a8?raw)
