insight-oracle
Decision-input integrity for onchain AI agents: verify oracle prices before signing a trade.
- 0.3.0
- Version
- remote
- Transport
- 40
- Tools
Security review
Review passedReviewed 37m ago.
- tools: 40 tools scanned
- metadata: scanned
No findings.
Tools (40)
assess_rwa_evidence
Evaluate supplied RWA/tokenized-stock evidence against an explicit policy. Unsigned diagnostic only: caller-supplied facts are not authenticated, and ALLOW does not authorize a trade. Existing pre-trade and authorization checks remain required.
get_robinhood_rwa_instrument
Resolve a Robinhood Stock Token to Insight committed master data, using share-class FIGI for the underlying and ISO 10383 MIC for its primary market, then cross-check issuer UID, ISIN and contract deployment. Reference/admission evidence only; it never counts toward price quorum or authorizes a trade.
get_robinhood_rwa_context
Get Robinhood Stock Token issuer context: official asset identity, trading capabilities, halt state, corporate actions, multiplier-normalized reference price, and optional on-chain ERC-8056 verification. First-party evidence only; it is not an independent oracle and never counts toward oracle quorum or authorizes a trade.
get_oracle_price
Fetch the latest price from a specific oracle provider for an asset.
get_consensus_price
Get the aggregated consensus price for an asset across multiple oracle providers. Useful when you need a robust, manipulation-resistant reference price.
get_risk_summary
Get a composite risk summary for an asset across selected oracle providers. Includes HHI concentration, volatility, correlation, freshness, manipulation resistance, and shared-dependency risk.
get_oracle_health
Get the ecosystem-wide oracle health report for a specific date (uptime, staleness, and success rates across all providers). Use this for a dated snapshot of overall health. For a single feed by UUID use get_feed_health; to scan current freshness across many feeds use get_feed_freshness.
check_liquidation_risk
Check protocol liquidation risk for a specific date. Returns stress-test results based on representative benchmark positions.
compare_oracle_deviation
Compare historical price deviations across oracle providers for an asset. Helps identify which providers consistently diverge from consensus.
get_stablecoin_peg
Check stablecoin peg status. Provide a symbol for a specific stablecoin, or omit it to get all tracked stablecoins.
get_protocol_risk_params
Get risk parameters for a specific DeFi protocol, including liquidation thresholds, LTV ratios, and collateral factors.
get_symbols
List supported asset symbols. Optionally filter by a search query. Use this when you are unsure whether a symbol is supported.
recommend_oracle_setup
Recommend oracle provider setup for an asset based on active feeds. Use this to decide which providers to include in price feeds or risk analysis.
get_stablecoin_list
List all tracked stablecoin symbols.
get_oracle_prices_batch
Fetch prices for multiple assets/providers in a single request. Up to 20 queries.
get_price_history
Get historical price data for an asset from a specific oracle provider over a period (in hours).
get_cross_chain_spreads
Get pairwise price spreads across chains for a given provider and symbol. Useful for cross-chain arbitrage and risk tracking.
get_wrapped_asset_peg
Check wrapped asset (e.g. WBTC, wstETH) peg status. Provide a symbol for a specific asset, or omit it to get all tracked wrapped assets.
get_protocols
Get a list of lending protocols with dynamic data (TVL, asset counts, oracle providers used). Optionally filter by name/slug query.
get_protocol_oracle_exposure
Analyze oracle provider concentration risk for a specific lending protocol. Shows which providers cover which assets and concentration metrics.
get_feed_freshness
Scan current freshness/staleness across many active feeds, filterable by provider, symbol, or category. Use this to find feeds needing attention right now. For a single feed by UUID use get_feed_health; for a dated ecosystem-wide report use get_oracle_health.
get_feeds
List oracle feeds from the registry with optional filters (provider, symbol, category, chain, active status). Useful for discovering available feeds and their metadata.
get_feed_health
Get detailed point-in-time health status for ONE specific oracle feed by its UUID (consecutive failures, last success/failure, status). For ecosystem-wide health by date use get_oracle_health; to scan freshness across many feeds use get_feed_freshness.
get_feed_uptime
Analyze feed data-delivery reliability over a date range: success rate, hours with data, coverage %, and average snapshots per day per provider+symbol. Use this to assess how completely a feed delivered data over time — distinct from get_feed_health (point-in-time status) and get_latency (speed).
get_reputation_rankings
Get oracle provider reputation rankings with trend over a period (1-90 days).
get_provider_reputation
Get detailed reputation metrics for a specific oracle provider, optionally with historical trend.
get_daily_report
Get the full daily oracle/risk report for a specific date, including liquidation risks, anomalies, and market summary.
get_incidents
Get oracle incidents and deviation events within a date range. Filter by provider and minimum severity.
get_latency
Analyze 15-minute oracle collector latency statistics (min, mean, p50, p90, p95, p99) over a date range, optionally filtered by provider or symbol.
get_anomalies
Get aggregated oracle anomaly events over a lookback period (1-30 days), including top deviation events and risk impacts.
get_correlation
Compute pairwise Pearson correlation of oracle provider deviations for an asset over a date range. Helps identify independent vs correlated providers.
get_coverage
Identify oracle coverage gaps and single-provider-risk symbols (assets served by only one oracle — a concentration risk). Returns breakdowns by provider, chain, and symbol. Use this when assessing where coverage is thin. For ecosystem scale plus top reputable providers, use get_metrics instead.
get_metrics
Compact ecosystem overview: provider/feed/symbol/chain/category counts plus top providers ranked by reputation score. Use this for a quick scale snapshot or provider ranking. To find coverage gaps and single-provider risk, use get_coverage instead.
check_position_safety
Check the safety of a DeFi lending position against oracle deviation stress tests. Supports multi-asset or single-asset positions.
pre_trade_safety_check
Pre-trade oracle safety checkpoint for AI agents. Call this BEFORE executing any on-chain swap/borrow/lend/liquidation/repay to assess oracle risk. Aggregates cross-oracle consensus prices, per-provider deviation, data freshness, stablecoin peg status, and reputation into a single verdict: PASS / CAUTION / DANGER / BLOCK. AI agents MUST NOT execute trades when the verdict is DANGER or BLOCK. Also returns a recommended maximum position size. A PASS is not principal authorization or a guarantee of price correctness or economic safety.
oracle_watch
Ongoing cross-oracle risk signal for an asset: current consensus deviation, agreement, quorum, outliers and staleness condensed into a NORMAL / CAUTION / DANGER verdict with a proceed / proceed_with_caution / halt recommendation. Agents should gate long-running strategies (yield, keeper, portfolio) on this signal, not just one-off trades. Pair it with pre_trade_safety_check for the decision moment.
oracle_watch_history
Retrospective Oracle Watch trend for an asset: verdict stability, degraded-time ratio, worst deviation and mean credibility over the last N days, plus the recent series. Use it to judge whether a feed has been dependable, not just whether it is healthy this instant. History is guaranteed only for the committed universe (ETH/BTC/USDC/USDT x ethereum/arbitrum/base); other pairs return a live point signal from oracle_watch but no curve.
execution_receipt
Issue signed execution-price evidence comparing an observed fill with the oracle-assessed quote and signed slippage band. Provide the pre-trade fields (preTradeUid, requestHash, asset ids, chain, oracle gate counts) plus the settlement txHash. Insight collects the on-chain fill, signs a receipt paired to the pre-trade via preTradeUid + requestHash, and returns a FAITHFUL / DEVIATED / NOT_EXECUTED / UNDETERMINED verdict. This reports supported price/fill fidelity, not principal authorization or overall transaction safety. Pair it with pre_trade_safety_check and oracle_watch.
agent_begin_trade
Obtain oracle assessment evidence for a swap/DeFi intent BEFORE trading. Insight runs the oracle safety check and, if the verdict is PASS/CAUTION, returns a machine-readable "execution certification handle": preTradeUid, requestHash, CAIP-19 asset ids, the certified price (destination per source) and maxSlippageBps, plus participant/source-group counts and the pre-trade signing time. Execute the trade with YOUR wallet, then call execution_receipt with this handle + txHash to obtain the signed, verifiable Execution Receipt. If the verdict is DANGER or BLOCK this tool refuses (do not trade). This is oracle assessment evidence, not principal authorization — pair it with execution_receipt.
verify_execution_pair
Verify that a pre-trade oracle-safety attestation and an Execution Receipt describe the same assessed trade and that the certify → execute → prove loop closed. Returns pairedValid, the closed-loop status (CLOSED_FAITHFUL / CLOSED_DEVIATED / CLOSED_NOT_EXECUTED / CLOSED_UNDETERMINED, PRICE_-prefixed on v3 receipts whose signed verdict is priceExecutionStatus, or PAIR_INVALID), and the binding assertions (preTradeUid, requestHash, destination gate + preTradeUidsHash on v3, chain, asset). On a v3 receipt that commits to a destination gate, pass destinationPreTradeAttestation or the pair cannot close. This checks assessment/price-evidence binding; it does not establish principal authorization, price correctness, or economic safety. Pair it with agent_begin_trade and execution_receipt.