# Fia Signals x402 API

Fia Signals is a pay-per-call crypto market intelligence API for autonomous agents, trading bots, and swap pipelines.

Base URL: https://x402.fiasignals.com
Payment: x402 exact payments, USDC on Base mainnet (eip155:8453)
Pay-to: 0x8D32c6a3EE3fB8a8b4c5378F7C5a26CC320a853F
Discovery: https://x402.fiasignals.com/.well-known/x402.json
OpenAPI: https://x402.fiasignals.com/openapi.json
Bazaar resources: https://x402.fiasignals.com/discovery/resources

Best first endpoint:
- GET /token-safety/batch?chain=base&token_addresses=0xA,0xB — 0.10 USDC. Best value: screen up to 5 Base tokens before swap.
- GET /token-safety?chain=base&token_address=0x... — 0.03 USDC. Single-token fallback returning safe/risky/blocked.
- GET /fear-greed — 0.05 USDC. Live Fear & Greed JSON for checkout verification.

Other useful endpoints:
- GET /prices?symbols=BTC,ETH,SOL — 0.20 USDC. Real-time spot prices.
- GET /funding — 0.20 USDC. Perpetual futures funding rates.
- GET /regime — 1.00 USDC. BTC volatility/regime signal with confidence.
- GET /signals?symbol=BTCUSDT&interval=1h — 4.00 USDC. RSI/MACD/Bollinger signal bundle.

Integration flow:
1. Request a paid endpoint.
2. Read the payment-required challenge.
3. Pay with x402 on Base USDC.
4. Retry with X-PAYMENT.
5. Receive JSON.

Proof:
The /fear-greed paid flow has settled end-to-end on Base. A 0.05 USDC canary moved from Beta wallet to pay-to at block 45143152.
The /pre-trade-risk paid flow has settled end-to-end on Base. A 0.03 USDC canary moved from Beta wallet to pay-to at block 45145811.

Pre-trade risk contract:
- Input: chain plus EVM token address.
- Output: verdict safe/risky/blocked, safety_score, reasons, confidence, sources, and raw composite data.

Example calls:
- Known blue-chip check: /token-safety?chain=base&token_address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Unknown token check: /token-safety?chain=base&token_address=0xTOKEN
- Batch candidate screen: /token-safety/batch?chain=base&token_addresses=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0xdac17f958d2ee523a2206206994597c13d831ec7
- Block before swap if verdict is blocked; reduce size or require confirmation if verdict is risky.

Minimal buyer-agent pseudocode:
1. Call /token-safety/batch before executing swaps when screening multiple candidates, or /token-safety for one token.
2. If the response is 402, pay the x402 challenge and retry with X-PAYMENT.
3. If verdict=blocked, do not trade.
4. If verdict=risky, reduce size or request stronger confirmation.
5. If verdict=safe, continue normal execution.

Copy/paste HTTP shape:
curl -i "https://x402.fiasignals.com/token-safety?chain=base&token_address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

Expected paid response fields:
{"verdict":"safe|risky|blocked","action":"PROCEED|CAUTION|REJECT","safety_score":0-100,"confidence":"low|medium|high","reasons":[],"warnings":[],"sources":[],"raw_checks":{}}

Contact: fia-trading@agentmail.to