# Insight — Decision-Input Integrity & Oracle Risk Intelligence for Onchain Agents > Decision-input integrity for AI agents trading onchain. Before your agent signs a swap, borrow, or perp order, check whether the price it is about to trust can be trusted: multi-provider oracle consensus (13 providers, 40+ chains), manipulation-risk scoring, cross-source agreement and feed health, returned as a signed EIP-712 verdict (PASS/CAUTION/DANGER/BLOCK) that a third party can re-verify offline. Paid via x402 (MPP also accepted, see below): USDC, $0.002–$0.040 per call (Trade Guard is op-priced; product prices below), no signup or API key required. ## Paid API (x402) - [Pre-trade safety check](https://www.oracleinsight.xyz/api/v1/safety/pre-trade): GET. Query params: `asset` (e.g. ETH), `chainId` (e.g. 1), `action` (e.g. swap), `tradeAmountUsd` (e.g. 1000), all required; optional `targetProviders`, `protocolId`, `schemaVersion` (2 or 3; v3 adds quorum and independence gates verifiable from signature bytes). Example response fields: `verdict`, `staleDataRisk`, `consensusPrice`, `maxDeviationPct`, `participantCount`, `manipulationRiskScore`, `crossProviderAgreement`, `recommendedMaxPositionUsd`. - [Execution preflight](https://www.oracleinsight.xyz/api/v1/safety/preflight): GET. A chain-neutral `allow` / `caution` / `block` decision over the strict oracle assessment and an optional fresh venue quote. Query params: `asset`, `chainId`, `action`, `tradeAmountUsd`; `destinationAsset` is optional. A supplied decision-input quote is required for `allow`; Monad results additionally surface Pyth Core evidence. Set `targetProviders=pyth` for a low-latency native Pyth Core snapshot; it remains `caution` under the strict multi-provider quorum policy. Paid with an API key or x402 ($0.02 per successful request). - [Monad Lending Guard](https://www.oracleinsight.xyz/api/v1/safety/monad-lending-guard): GET. Read-only, pre-signing assessment for direct Aave V3 Monad calls or exact Morpho Blue Monad markets. Required query params: `protocolId` (`aave-v3-monad` or `morpho-blue-monad`), `action` (`supply` or `borrow`), `collateralSymbol`, `loanSymbol`, `collateralValueUsd`, and `debtValueUsd`; `marketId` is also required for Morpho. It checks live protocol controls plus separate collateral/debt oracle evidence and returns `ALLOW`, `CAUTION`, or `BLOCK`. Paid with an API key or x402 (C3, $0.02 per complete decision). It never authorizes, signs, or broadcasts a transaction. - [HyperEVM Lending Guard](https://www.oracleinsight.xyz/api/v1/safety/hyperevm-lending-guard): GET preview / POST exact-call. Read-only, pre-signing decision for direct HyperLend Core (Aave V3 fork) supply or borrow on HyperEVM (chain 999) with reviewed WHYPE, WSTHYPE, UBTC, UETH, USDe, sUSDe, USDT0, KHYPE, and USDC markets. Same C3 pricing; never authorizes or broadcasts a transaction. - [Base Lending Guard](https://www.oracleinsight.xyz/api/v1/safety/base-lending-guard): GET preview / POST exact-call. Read-only, pre-signing decision for Aave V3, exact Morpho Blue markets, Compound V3 Base USDC Comet, or reviewed Moonwell Base markets. Same C3 pricing; never authorizes or broadcasts a transaction. - [Base Perp Guard](https://www.oracleinsight.xyz/api/v1/safety/base-perp-guard): GET preview / POST exact-call. Decision-input integrity gate for opening a Synthetix Perps V3 position on Base (reviewed BTC, ETH, SOL, XRP, DOGE, PEPE markets, USDC margin): separate underlying/margin oracle integrity plus leverage vs reviewed market caps. Same C3 pricing; never signs, broadcasts, or authorizes an order. - [Hyperliquid Perp Guard](https://www.oracleinsight.xyz/api/v1/safety/hyperliquid-perp-guard): GET preview / POST exact-call. Decision-input integrity gate for one declared Hyperliquid HyperCore order intent; POST binds the exact unsigned exchange envelope (intent hash, asset index, size, price, expiry) into a signed decision. Same C3 pricing; never signs, submits, or authorizes an order. - [Multichain EVM Lending Guard](https://www.oracleinsight.xyz/api/v1/safety/multichain-evm-lending-guard): GET preview / POST exact-call. Read-only, pre-signing decisions for Aave V3 (Polygon/Arbitrum/BNB), Venus Core and Lista Moolah (BNB), Compound V3, Dolomite, Euler v2, and Fluid T1 (Arbitrum/Base), and Morpho Blue (Polygon/Arbitrum). Same C3 pricing. - [Solana Lending Guard](https://www.oracleinsight.xyz/api/v1/safety/solana-lending-guard): POST. Read-only, pre-signing decision for one direct Kamino Lend, Marginfi v2, Jupiter Lend Earn, or Save Lend deposit instruction; the exact unsigned Solana message is simulated before an optional Ed25519 decision attestation. Same C3 pricing. - [Solana Perp Guard](https://www.oracleinsight.xyz/api/v1/safety/solana-perp-guard): GET. Read-only, pre-trade decision gate for opening a Drift Protocol v2 perpetual position on Solana mainnet (reviewed SOL, BTC, and ETH markets, USDC margin); separate underlying and USDC cross-oracle consensus checks, leverage vs a reviewed profile capped by the live Drift margin ratio, and disclosed on-chain venue evidence (Drift mark price vs Pyth Lazer oracle deviation, funding rate, open interest, market status). Same C3 pricing; never signs, submits, or authorizes an order. - [Solana Swap Guard](https://www.oracleinsight.xyz/api/v1/safety/solana-swap-guard): POST. Read-only, pre-signing decision for exactly one unsigned Orca Whirlpool USDC/USDT 0.01% swap on Solana mainnet (both directions); the single swap instruction is decoded and re-verified against live mainnet state, the pool is priced against independent oracle consensus, the exact unsigned message is simulated, and an ALLOW attestation is bound to the message hash. Same C3 pricing; never authorizes or broadcasts a transaction. - [Loopscale Vault Deposit Guard](https://www.oracleinsight.xyz/api/v1/safety/loopscale-vault-deposit): POST. Pre-signing preparation for one official Loopscale Solana lending-vault deposit, with live vault metadata validation and exact-message simulation. Same C3 pricing. - [Verified Swap Intent](https://www.oracleinsight.xyz/api/v1/safety/swap-intent): two signed schema-v3 Pre-Trade gates for one same-chain swap plus one execution-receipt credit after x402 settlement. A BLOCK is a complete, charged decision. - [Oracle Watch Monitored Window (24h)](https://www.oracleinsight.xyz/api/v1/safety/oracle-watch-window): POST, $0.50 per 24h window. One settlement pre-pays Oracle Watch monitoring coverage for one (symbol, chain) position: up to 48 signal polls per window at least 30 minutes apart (one full reassessment every 30 minutes, escalating to a full scan when the signal jumps). In-window polls are token-authenticated and never charged per call, bounded by 10 polls per rolling minute per API key and at most 5 open windows per API key (concurrency over-limit: HTTP 429 with no Retry-After — close a window; poll-rate over-limit: HTTP 429 + Retry-After). Assessment and evidence only — no custody, no execution authority. - [Position Lifecycle Bundle (24h)](https://www.oracleinsight.xyz/api/v1/safety/position-lifecycle): POST, $0.55 per 24h lifecycle. One settlement pre-pays an embedded Oracle Watch window (48 free signal polls), 4 bundled guard assessments across any position-guard family, and 1 attested execution receipt for one (symbol, chain) position; at most 3 open lifecycles and 5 open windows per API key (the embedded window counts toward the window cap). Bundled calls are token-authenticated; concurrency over-limit returns HTTP 429 with no Retry-After. Assessment and evidence only — no custody, no execution authority. - [MCP endpoint](https://www.oracleinsight.xyz/api/mcp): POST (JSON-RPC, streamable HTTP). `initialize`, `tools/list` and `ping` are free without credentials (20 advertised names: the four product tools `trade_guard`, `trade_proof`, `oracle_watch_window` and `position_lifecycle`, plus 16 deprecated aliases that are callable at the same price until their removal on 2027-01-06). `tools/call` from an agent without an API key is paid per call via x402: the HTTP 402 quote prices the call from the tool's metering class or product price (1 credit = $0.001; see Product prices below); retry with `PAYMENT-SIGNATURE` as below. With an `X-API-Key` header, calls meter against the credit wallet instead. - [Base Agent Swap Guard](https://github.com/imokokok/Insight/blob/main/docs/base-agent-swap-guard.md): legacy MCP tool `prepare_base_agent_swap_guard` (C3 / $0.02 through x402). It is callable by name via `tools/call` but not advertised in `tools/list`; it sits outside the 20 discoverable names and is removed on 2027-01-06. For one Base-mainnet reviewed direct Aerodrome Slipstream WETH→USDC CL100 or PancakeSwap V3 USDC→USDT 0.01% proposal, it returns `ALLOW`, `CAUTION`, or `BLOCK`; only `ALLOW` returns byte-bound unsigned approval and swap calldata for human confirmation. It never signs, routes, relays, or broadcasts a transaction. - [Solana Swap Guard lifecycle](https://github.com/imokokok/Insight/blob/main/docs/solana-swap-guard.md): legacy MCP tools `solana_swap_guard` (C3 / $0.02) plus `settle_solana_swap_guard` (C4 / $0.04) and free offline verification via `verify_solana_swap_guard_settlement` through x402. These are callable by name via `tools/call` but not advertised in `tools/list`; they sit outside the 20 discoverable names and are removed on 2027-01-06. For exactly one unsigned Orca Whirlpool USDC/USDT 0.01% swap on Solana mainnet (both directions), `solana_swap_guard` returns `ALLOW`, `CAUTION`, or `BLOCK`; only an `ALLOW` attestation is returned and it is bound to the exact message hash, with no executable payload for CAUTION or BLOCK. After execution, the settlement re-collects on-chain SPL balance deltas and returns a signed SETTLED / REVERTED / UNRECONCILED closure. The tools never sign, submit, relay, or authorize a transaction. ## Product prices - **Trade Guard** — $0.002–$0.040 per call, op-priced. Read-only ops (`oracle_price`, `market_quote`, `search_registry`) are 2 credits / $0.002 and `price_analytics` / `oracle_health` are 4 credits / $0.004. The trade-safety ops (`check_safety`, `prepare_swap`, `prepare_perp_order`) are **40 credits / $0.040 each**, which is both the per-op price and the product ceiling. - **Trade Proof** — 40 credits / $0.040 per call (`begin_evidence`, `issue_receipt`). `verify_evidence` is free for the three offline kinds (`execution_pair`, `base_agent_swap`, `solana_swap`); only verification that reads a live upstream is 40 credits / $0.040. - **Oracle Watch** — 500 credits / $0.500 per 24h window. - **Position Lifecycle** — 550 credits / $0.550 per position (embedded window, 4 guards and 1 receipt). - Deprecated aliases are callable at the same price as their canonical product op until 2027-01-06. They are not declared as separate products. ## When a call is not charged - An MCP `rejected` verdict that carries all five evidence items is a complete answer and is charged at the call's normal price. - A `rejected` verdict missing any of the five evidence items is downgraded to `unavailable` and is never charged. - REST endpoints do not emit `rejected` / `unavailable`; they are charged when data is delivered. ## One-command MCP install and attribution Any MCP host can connect with no API key and no local checkout: `npx -y --package=oracle-insight-mcp insight-mcp` The launcher pins `https://www.oracleinsight.xyz/api/mcp` and sends `x-insight-entry-source: mcp`. Set `INSIGHT_MCP_URL` for a self-hosted endpoint or `INSIGHT_API_KEY` (plus the `INSIGHT_ENTRY_SOURCE` label if needed) in the MCP host's `env` block. `initialize`, `tools/list`, and `ping` are free; `tools/call` is priced by metering class. Clients may send `x-insight-entry-source` with one bounded, non-identifying label: `direct`, `docs`, `bazaar`, `mcp`, `sdk`, `skill`, `wallet_mcp`, `sendaifun`, `solana_directory`, or `unknown`. It is used only for aggregate conversion analysis and never affects pricing, authorization, verification, or settlement. Omitting it is fully supported. HTTP 402 responses also carry `x-insight-quickstart`, `x-insight-mcp-install` and `x-insight-no-wallet` hints. ## Zero-wallet trial (no crypto needed) If an agent has no wallet, use the existing credit rail instead of x402: 1. Sign up at https://www.oracleinsight.xyz and verify the email address. A one-time, idempotent grant of 400 credits is issued to the account (about 20 C3 pre-trade decisions; 1 credit = $0.001). 2. Create an API key at https://www.oracleinsight.xyz/settings?tab=api-keys. 3. Send `X-API-Key: ` on REST calls, or set `INSIGHT_API_KEY` in the MCP host's `env` block for the launcher. No wallet, USDC, private key or `@x402/fetch` client is required. This is a per-account, email-verified, one-time grant — not an anonymous free tier and not a recurring allowance. It uses the same metering, quota and safety boundary as any paid API key; verdicts are identical. HTTP 402 responses carry `x-insight-no-wallet` with this hint. ## Payment flow (x402 v2, exact scheme) 1. GET the endpoint without payment credentials. You receive HTTP 402 with a `PAYMENT-REQUIRED` response header containing the live base64url JSON challenge. 2. Read an entry from its `accepts[]` array and register the matching client scheme. The current deployment's network, asset, payee, token-domain metadata, and facilitator flow are authoritative; do not hard-code a Base, EIP-3009, or payee example. 3. Sign the selected requirement and retry with `PAYMENT-SIGNATURE`. A successful settlement returns HTTP 200 with the verdict JSON. ## Optional MPP rail If a response includes a `WWW-Authenticate: Payment` challenge, it is an additional MPP payment contract for that exact request. Read its live method, scope, asset, network, payee, and amount before signing; it is not implied by the x402 option or by a historical example. ## Machine-readable discovery - [x402 pay-per-call quickstart](https://www.oracleinsight.xyz/docs/x402): copy-paste clients for curl, TypeScript (@x402/fetch), Python (x402[httpx,evm]), and MCP tools/call; query parameters, metering classes (C1 $0.002, C2 $0.004, C3 $0.02, C4 $0.04), and receipt verification. - [OpenAPI discovery document](https://www.oracleinsight.xyz/openapi.json): x402-focused discovery doc for the paid endpoint, including the `x-payment-info` pricing block and parameter schemas. - [x402 well-known manifest](https://www.oracleinsight.xyz/.well-known/x402.json): resource-server manifest (also served at [/.well-known/x402](https://www.oracleinsight.xyz/.well-known/x402)). - [x402-quality/v0 schema](https://www.oracleinsight.xyz/x402-quality/v0/x402-quality-v0.schema.json): draft JSON Schema (2020-12) for a quality-attestation artifact, plus a zero-dependency projection tool and fixtures generated from live receipts. A reference implementation for the x402 quality-attestation discussion, not an adopted standard. - [ERC-8004 evidence descriptor (v1)](https://www.oracleinsight.xyz/erc8004/v1/insight-evidence.v1.json): how Insight's signed pre-trade attestations and quality receipts anchor into ERC-8004 agent Reputation/Validation registries (source: docs/erc8004-reputation-evidence.md). - [Portfolio capability catalog](https://www.oracleinsight.xyz/.well-known/portfolio-capabilities.json): the canonical machine-readable directory for Insight, PriorSeal, and the integrated decision-to-evidence workflow; includes the Base ERC-8004 registration and ERC-8021 Builder Code. ## Free (keyless) endpoints - [POST /api/v1/safety/attestation/verify](https://www.oracleinsight.xyz/api/v1/safety/attestation/verify): verify an EIP-712 attestation receipt (keyless, no charge). - [GET /api/v1/symbols](https://www.oracleinsight.xyz/api/v1/symbols): list supported feed symbols (keyless). Other data endpoints (oracle health, feeds, deviation, reports) require an API key; see the [OpenAPI reference](https://www.oracleinsight.xyz/openapi.yaml).