# Fia Signals x402 Token Safety Integration

Status: listed, indexed, live, buyer-agent ready. External demand is not yet proven.

## What This Is

Fia Signals is a pay-per-call pre-swap token risk gate for autonomous trading agents, swap routers, rebalancers, and agentic trading workflows.

Primary endpoint:

```text
GET https://x402.fiasignals.com/token-safety/batch
```

Use it before executing a swap to screen up to 5 Base/EVM token contracts for rugpull, honeypot, liquidity, and market risk.

## Discover

Recommended discovery path for buyer agents:

1. Open agentic.market.
2. Browse Trading.
3. Search for token safety, rugpull, honeypot, pre-swap risk, or Fia Signals.
4. Read the live integration metadata from:

```text
https://x402.fiasignals.com/quickstart.json
https://x402.fiasignals.com/.well-known/agent.json
https://x402.fiasignals.com/openapi.json
https://x402.fiasignals.com/llms.txt
```

## Install Buyer Wallet Skills

For Coinbase/AgentKit-style buyer agents:

```bash
npx skills add coinbase/agentic-wallet-skills
```

Use your x402-capable wallet client to sign the payment challenge and retry the request with `X-PAYMENT`.

## Call Flow

1. Send the target GET request without `X-PAYMENT`.
2. Receive HTTP `402 Payment Required`.
3. Follow the `Link` header to `https://x402.fiasignals.com/quickstart.json` if your agent needs integration hints.
4. Parse the `payment-required` challenge.
5. Sign with your x402 wallet for Base USDC.
6. Retry the same URL with `X-PAYMENT`.
7. Parse the JSON response before executing the swap.

## Canonical Request

```text
https://x402.fiasignals.com/token-safety/batch?chain=base&token_addresses=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006
```

Price: `0.10 USDC` for up to 5 token addresses.

Network: `eip155:8453` Base mainnet.

Asset: Base USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`.

Pay-to: `0x8D32c6a3EE3fB8a8b4c5378F7C5a26CC320a853F`.

## Slash URL Compatibility

The old parser-bug URL redirects permanently:

```text
/token/safety/batch -> 308 -> /token-safety/batch
```

Buyer agents should use `/token-safety/batch` directly.

## Expected Response Shape

```json
{
  "count": 2,
  "limit": 5,
  "chain": "base",
  "summary": {"safe": 1, "risky": 1, "blocked": 0, "error": 0},
  "results": [
    {
      "verdict": "safe",
      "action": "PROCEED",
      "safety_score": 90,
      "confidence": "medium",
      "reasons": [],
      "warnings": [],
      "sources": ["GoPlus", "DexScreener"],
      "raw_checks": {}
    }
  ]
}
```

## Truth Status

- Listed: yes.
- Indexed: yes.
- Live endpoint: yes.
- Buyer-agent ready: yes.
- External demand proven: no.

Internal diagnostic buys, crawler probes, and controlled canaries are not external demand and should not be reported as traction.