--- name: x402.fiasignals.com description: x402.fiasignals.com provides pre-trade token safety screening and swap simulation for EVM chains, with a focus on Base. It offers batch contract risk analysis and ACP-bridge endpoints that return job-create coordinates for guarded swap dry runs and offer angle diagnostics. host: x402.fiasignals.com --- # x402.fiasignals.com Fia Signals is a pre-execution risk and simulation host targeting agents that need to gate token trades before funds move. It serves agents operating on Base and other EVM chains that require honeypot detection, tax analysis, holder concentration checks, and swap simulation. Its ACP-bridge skills are specifically designed for the Virtuals ACP job framework, making it distinct from generic price-feed or DEX-aggregator hosts. ## When to use this host Use this host when an agent needs pre-trade token safety verdicts on EVM chains (especially Base) or needs to simulate a Base swap via the Virtuals ACP framework before executing. It is the right choice for honeypot detection, tax and holder risk screening, and ACP-gated dry runs. Do not use it for post-trade analysis, portfolio monitoring, real-time streaming price feeds, or live swap execution — it provides no execution capability itself. For actual swap routing or live price quotes, use a DEX aggregator host. For non-EVM chains, this host is not applicable. The ACP-bridge skills require a functioning Virtuals ACP job pipeline; agents without ACP infrastructure should use the direct batch safety skills instead. ## Capabilities ### Token Safety Screening Batch-checks EVM token contract addresses for safety risks including honeypots, mint risk, tax rates, holder concentration, and liquidity, returning actionable verdicts before any trade is executed. - **`check-token-safety-batch`** — Checks up to 5 token contract addresses on Base (or another EVM chain) for safety, returning a verdict, safety score, contract risk indicators, holder risk, and market context per token. - **`batch-pre-trade-risk-check`** — Runs pre-trade risk analysis on multiple EVM token addresses in a single request, returning verdicts, safety scores, contract security flags, holder risk metrics, and market data for each token. ### ACP Bridge Coordinates Returns ACP job-create coordinates and schemas for downstream Virtuals ACP jobs, enabling agents to hand off guarded swap dry runs and offer angle diagnostics to the Fia Signals seller agent. - **`fetch-guarded-swap-dry-run-coordinates`** — Returns ACP job-create coordinates for the guarded_swap_execute_dry_run offering, which simulates a Base chain swap and returns GO/CAUTION/BLOCK verdict, execution readiness, route estimate, and proof that no funds moved. - **`fetch-angle-offer-ping-coordinates`** — Returns ACP job-create coordinates for the offer_angle_ping service, including seller wallet, offer schema, requirements schema, output schema, and a ready-to-run job-create command. ## Workflows ### Safe Swap Pre-Flight on Base *Use when an agent needs to validate a token and simulate a swap on Base before committing funds, combining safety screening with a dry-run execution check.* 1. **`check-token-safety-batch`** — Screen the target token address on Base for honeypot, tax, holder, and liquidity risks; abort if verdict is BLOCK. 2. **`fetch-guarded-swap-dry-run-coordinates`** — Retrieve ACP job-create coordinates for the guarded swap dry run, then create and complete the ACP job to obtain a GO/CAUTION/BLOCK verdict and route estimate without moving funds. ### Batch Screen Then ACP Dry Run *Use when an agent needs to screen multiple tokens and then simulate a swap for the token that passes safety checks.* 1. **`batch-pre-trade-risk-check`** — Run pre-trade risk analysis on multiple token addresses to identify safe candidates, filtering out risky or blocked tokens. 2. **`fetch-guarded-swap-dry-run-coordinates`** — For the safe candidate token, fetch ACP coordinates and complete the guarded swap dry run job to confirm execution readiness before trading. ## Skill reference ### `batch-pre-trade-risk-check` **Batch Pre-Trade Risk Check** — Runs pre-trade risk analysis on multiple EVM token addresses in a single request, returning verdicts, safety scores, contract security flags, holder risk metrics, and market data for each token. *Use when:* Use when an agent needs to screen one or more token addresses for trading safety before executing swaps, checking for honeypots, mint risk, tax rates, holder concentration, and liquidity on a given chain. *Not for:* Do not use for post-trade analysis or portfolio monitoring; this is a pre-execution gate check only. Not suitable for non-EVM chains. **Inputs:** - `chain` (string) — EVM chain name to query. Defaults to 'base'. - `token_addresses` (string) — Comma-separated list of EVM token contract addresses to analyze in batch. **Returns:** Returns a batch result with count, limit, chain, a summary of safe/risky/blocked/error counts, and a results array with per-token verdict, action, safety_score, confidence, market_data, contract_security flags, and holder_risk metrics. **Example:** `GET https://x402.fiasignals.com/pre-trade-risk/batch?chain=base&token_addresses=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006` --- ### `fetch-guarded-swap-dry-run-coordinates` **Guarded Swap Dry Run (ACP Bridge)** — Returns ACP job-create coordinates for the guarded_swap_execute_dry_run offering, which simulates a Base chain swap and returns GO/CAUTION/BLOCK verdict, execution readiness, route estimate, and proof that no funds moved. *Use when:* Use when an agent needs to preview a Base chain token swap before executing it for real, specifically to obtain ACP job-create coordinates so the agent can create and complete a Virtuals ACP job that returns a safety verdict and route estimate without moving funds. *Not for:* Do not use when you need an actual executed swap or a live price quote; this endpoint returns ACP handoff coordinates only — the underlying ACP job must be created and completed separately to receive the dry-run verdict. **Returns:** Returns a bridge packet with status, seller info, agent_id, bridge_price_usdc, and a selected_offer object containing the ACP job-create CLI command, requirements schema, and output schema keys (verdict, execution_ready, route, safety, proof). **Example:** `GET https://x402.fiasignals.com/acp-direct/guarded-swap-execute-dry-run` --- ### `fetch-angle-offer-ping-coordinates` **Angle Offer Ping ACP Bridge** — Returns ACP job-create coordinates for the offer_angle_ping service, including seller wallet, offer schema, requirements schema, output schema, and a ready-to-run job-create command. *Use when:* Use when an agent needs to retrieve the ACP job-create coordinates and requirements schema for the offer_angle_ping diagnostic service before constructing and submitting an ACP job to the Fia Signals seller agent. *Not for:* Do not use to directly receive an offer angle diagnostic result; this endpoint returns job-create coordinates only — the agent must separately create and complete the ACP job to obtain the actual diagnostic output. **Returns:** Returns a bridge-ready JSON packet with seller wallet, agent ID, offer description, requirements schema, output schema, and a CLI command to create the ACP job for the offer_angle_ping diagnostic. **Example:** `GET https://x402.fiasignals.com/acp-direct/offer-angle-ping` --- ### `check-token-safety-batch` **Token Safety Batch Check** — Checks up to 5 token contract addresses on Base (or another EVM chain) for safety, returning a verdict, safety score, contract risk indicators, holder risk, and market context per token. *Use when:* Use when an agent needs to gate or validate one or more token addresses before executing a swap or trade, requiring actionable safety verdicts (PROCEED/BLOCK), honeypot detection, tax checks, and liquidity data in a single call. *Not for:* Do not use for real-time streaming price feeds or continuous monitoring; this is a single-shot batch safety check. Not suitable for chains other than Base unless the chain parameter is explicitly supported. **Inputs:** - `chain` (string) — EVM chain to check tokens on. Defaults to 'base'. - `token_addresses` (string) — Comma-separated list of token contract addresses to check (up to 5 per the limit field in responses). **Returns:** Returns a batch result with count, limit, chain, a summary of safe/risky/blocked/error counts, and a results array per token containing verdict, action, safety_score, contract_security flags (honeypot, mint, taxes), holder_risk, and market_data (price, liquidity, volume). **Example:** `GET https://x402.fiasignals.com/token-safety/batch?chain=base&token_addresses=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006` ---