# 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
Buyer-agent manifest: https://x402.fiasignals.com/agent-launch.json
OpenAPI: https://x402.fiasignals.com/openapi.json
Bazaar resources: https://x402.fiasignals.com/discovery/resources
Virtuals ACP agent_id: 18788
Virtuals ACP hire link: https://app.virtuals.io/acp/agent-details/18788

Best first buyer-agent path:
- Preview first: GET /contract-risk-preview?chain=base&token_address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — free live sample plus generated ACP checkout command.
- Buy on Virtuals ACP: Fia Signals, seller_wallet 0xA23f0e343293d0D4BfF50cF32A55F1c037a60Ba6, offering contract_risk, price 0.01 USD.
- Exact ACP command: npm run acp -- job create 0xA23f0e343293d0D4BfF50cF32A55F1c037a60Ba6 contract_risk --requirements '{"chain":"base","token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}' --isAutomated true --json
- Direct-buy manifest: https://x402.fiasignals.com/virtuals-direct-buy.json?offering=contract_risk

x402 paid alternatives:
- POST /agent-trade-approval-ticket — 5.00 USDC. High-ticket APPROVE/CAUTION/BLOCK decision before an autonomous trade. Returns reasons, caps, source status, and proof flags no_execution/no_signer/no_wallet_action/no_funds_moved.
- Bankr/AgentKit pre-swap skill one-pager: GET /bankr-pre-swap-skill and machine-readable spec at /bankr-pre-swap-skill.json. It wraps /bundled-risk-pack as pre_swap_risk_check and returns PROCEED/CAUTION/BLOCK before a wallet agent signs or routes a swap.
- GET /fear-greed — 0.05 USDC. HEAD is discovery-only; do not attach x402 payment to HEAD. Strongest verified checkout rail: 3 paid attempts, 3 delivery YES, 0 paid delivery failures. Latest strict paid delivery: 2026-06-14T00:15:47Z, buyer 0x3803A19280DeeFe533D177C4A169412BD341101b, tx 0x0ca44cc649fdc9c5c785014be1f549a64fe9523638c824d7e59ad47639516c27.
- GET /contract-risk/batch?chain=base&token_addresses=0xA,0xB — 0.03 USDC. Screen up to 5 Base tokens before swap.
- GET /token-safety/batch?chain=base&token_addresses=0xA,0xB — 0.03 USDC. Alias for batch safety checks.
- GET or POST /bundled-risk-pack — 0.50 USDC. Distinct payable x402 route for repeat buyers who need a combined risk memo, ranked proceed/caution/reject queue, aggregate blocker reasons, and strict proof fields. The 0.03 USDC endpoints stay unchanged; this is not revenue until a distinct external 0.50 USDC payment tx_ref or completed ACP job exists.
- GET or POST /token-risk-pack-pro — 1.50 USDC. Distinct payable x402 route for buyer agents needing a 5-token batch report with honeypot, tax, liquidity, holder concentration, owner/admin risk, refund-on-fail envelope, JSON proof fields, and ranked PROCEED/CAUTION/REJECT queue. This is not revenue until a distinct external 1.50 USDC payment tx_ref and paid 200 delivery proof exist.
- GET or POST /prepaid-risk-pack-10 — 5.00 USDC. Distinct payable x402 route for buyer agents needing one prepaid PROCEED/CAUTION/BLOCK token-safety and contract-risk report across up to 10 Base/EVM candidates. No account, signer, custody, or future-credit balance. This is not revenue until a distinct external 5.00 USDC payment tx_ref, settlement success, and paid 200 delivery proof exist.
- Human checkout for prepaid-risk-pack-10: GET /prepaid-risk-pack-10/checkout — hosted pay page for buyers without x402-capable agents. Pays 5.00 USDC on Base to the same payTo wallet and requires external tx proof before any revenue booking.
- GET /token-safety?chain=base&token_address=0x... — 0.03 USDC. Single-token fallback returning safe/risky/blocked.

x402 to ACP bridge packets:
- GET or POST /acp-direct/guarded-swap-execute-dry-run — free; returns an ACP guarded_swap_execute_dry_run job-create handoff packet.
- GET or POST /acp-direct/token-safety-check — free; returns an ACP token_safety_check job-create handoff packet.
- GET or POST /acp-direct/offer-angle-ping — free; returns an ACP offer_angle_ping job-create handoff packet.
- Truth label for handoff responses: free_acp_handoff_not_acp_sale. The handoff is metadata only, not an underlying ACP sale by itself.

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.

ACP conversion proof-return:
- Completed paid ACP job: return job id, buyer wallet or buyer agent, seller wallet, offering, paid amount, completion status, and deliverable JSON.
- Paid x402 endpoint: return request URL, request id, X-PAYMENT proof or settlement tx, paid HTTP 200 response, and buyer wallet if available.
- Blocker path: return precise blocked step, raw response/status, payment/client/runtime error, and whether the buyer was non-internal.
- Internal canaries must be labelled INTERNAL_CANARY_NOT_REVENUE and never counted as external traction.

Proof:
The /fear-greed paid flow has settled end-to-end on Base with paid delivery observed. Current track record: 3 paid attempts, 3 delivery YES, 0 paid delivery failures. Latest strict paid delivery was 2026-06-14T00:15:47Z from buyer 0x3803A19280DeeFe533D177C4A169412BD341101b, tx 0x0ca44cc649fdc9c5c785014be1f549a64fe9523638c824d7e59ad47639516c27.
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:
- Required input: `chain=base&token_address=0x...` for single-token /pre-trade-risk, /token-safety, /contract-risk, and /smart-contract-risk calls.
- Do not probe the paid single-token route without `token_address`; use /contract-risk-preview for free schema/sample discovery.
- 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