# 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 or POST 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
```

## Runnable Reference Buyer

Public GitHub reference implementation:

```text
https://github.com/Odds7/fia-risk-aware-swapper
https://github.com/Odds7/fia-risk-aware-swapper/releases/tag/v0.1.0
```

Minimal dry-run path:

```bash
git clone https://github.com/Odds7/fia-risk-aware-swapper.git
cd fia-risk-aware-swapper
npm install
npm run dry-run
```

Caveats: no npm or PyPI package is published. TypeScript paid mode is the recommended integration path, but it still needs a separately approved paid canary before being called production-validated. Python paid mode is dry-run/reference only. This is a buyer integration reference, not proof of demand or external sales.

## 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 or POST 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 and method 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.03 USDC` for up to 5 token addresses.

Network: `eip155:8453` Base mainnet.

Asset: Base USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`.

Pay-to: `0x8D32c6a3EE3fB8a8b4c5378F7C5a26CC320a853F`.

## Risk-Pack Upsell

Same-day sales path: start with `GET or POST /token-safety/batch` or `/pre-trade-risk/batch` at `0.03 USDC` for up to 5 token candidates. Repeat buyers who need more than another isolated starter check should use the distinct payable bundled risk-pack route: `GET or POST /bundled-risk-pack` at `0.50 USDC` for a combined token-safety and contract-risk packet with a ranked proceed/caution/reject queue, aggregate blocker reasons, and strict proof fields. The existing `0.03 USDC` batch endpoints remain unchanged. Count it only after a distinct external 0.50 USDC payment tx_ref or completed ACP job exists.

## Dedup Alert Discipline

Reconcile once per unique x402 `tx_ref` across `x402_events` and `x402_sales`. Duplicate alerts for the same `tx_ref` are operating noise, not new revenue.

## 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.
- Verified x402 checkout proof: yes - HEAD/GET paid-compatible `/fear-greed` plus latest `/basis` strict paid delivery; `/funding` is the next no-price-change route experiment, not paid proof yet.
- ACP direct-buy external demand proven: no completed non-internal ACP job yet.

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

Dedup alert discipline: reconcile once per unique x402 tx_ref across x402_events and x402_sales. Duplicate alerts for the same tx_ref are operating noise, not new revenue.