PreFlyte#

The financial intelligence layer for DeFi agents.

PreFlyte helps AI agents make smarter financial decisions in DeFi. It sits between your agent's goal and its execution — answering the questions that prevent costly mistakes.

Existing DeFi skills help agents execute transactions. PreFlyte helps agents think before acting.

Read-only. No wallet access. No private keys. No transaction signing.

Works alongside any execution skill (BankrBot, Polyclaw, etc.) as a pre-trade intelligence layer.

---

Setup#

PreFlyte offers two access modes. Pick the one that suits your agent.

Option A — Free beta (API key)#

If you do not have a PREFLYTE_API_KEY set in your environment, register for one:

bash

curl -s -X POST 'https://api.preflyte.xyz/register?source=clawhub' \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "your-agent-name"}'

This returns your API key instantly. Store it as PREFLYTE_API_KEY. The key cannot be retrieved again.

Every tool requires the API key as the api_key parameter.

• REST API: https://api.preflyte.xyz (auth: X-API-Key header)
• MCP server: https://mcp.preflyte.xyz/mcp (transport: streamable-http)
• Rate limit: 60 requests per minute per key

Option B — Pay-per-request via MPP (no signup)#

For agents that prefer per-request micropayments (or are already wired up to the MPP/Tempo payments ecosystem), all tools are available at https://pay.preflyte.xyz as paid REST endpoints. No API key or registration required — just pay per request.

• Payment protocol: MPP (HTTP 402 challenge-response)
• Network: Tempo mainnet (chain ID 4217)
• Currency: USDC ( 0x20c000000000000000000000b9537d11c60e8b50)
• Discovery document: https://pay.preflyte.xyz/openapi.json
• Also listed on MPPScan

Pricing per request:

ToolPrice (USD)assess_opportunity$0.05estimate_net_position$0.03market_snapshot, check_entry_viability, check_pool_viability$0.02gas_timing, verify_claim, get_returns, get_ranking$0.01

Flow for MPP-capable agents: send a GET to the paid endpoint, receive a 402 challenge, submit payment on Tempo, retry with the payment credential, receive the response plus a Payment-Receipt header.

---

How PreFlyte is Structured#

PreFlyte is a unified platform made up of distinct components, each answering a different financial question. Two components are live today, with more on the way.

🔍 RealityCheck — "Is what I believe actually true right now?"#

RealityCheck is the data verification and market intelligence component. It gives agents ground truth about current market conditions so they never act on stale, hallucinated, or misleading data.

This is where the headline tool lives — assess_opportunity — the single call that orients an agent the moment it wakes up with capital to deploy.

Tools in RealityCheck:

assess_opportunity ⭐ Start here, every time. Given your capital amount, your strategy, and your risk profile — where should you go? Returns ranked opportunities across all chains with net APY calculated for your specific position size, gas cost analysis, rate anomaly detection, and capacity checks. Three modes:

• yield_farming — best lending rates, net APY after gas, break-even days
• active_trading — chain viability for frequent swaps, minimum profitable trade size, capital exhaustion timeline
• idle_capital — where to park money between trades, minimum hold time to profit

verify_claim — Submit one or more beliefs about market state and get TRUE or FALSE back with the actual current value. Supports single claims or batch verification (multiple claims in one call). Claim types: supply_rate, borrow_rate, price, gas, utilization.

get_market_snapshot — Complete current state of a specific lending market. Rates, risk parameters, token price, gas price, plus 7-day averages and anomaly flags that tell you whether current conditions are normal or unusual.

gas_timing — Is now a good time to transact? Current gas compared to 24-hour and 7-day averages, the cheapest hours of the day based on historical patterns, and cost estimates for common operations like Aave deposits and Uniswap swaps.

check_entry_viability — Before entering a lending position, verify the market is actually open. Checks whether the market is active, frozen, or has borrowing disabled, and whether supply or borrow caps have been reached. Prevents wasting gas on transactions that will revert.

estimate_net_position — Detailed financial projection for a specific lending position. Shows current rate, 7-day average, entry and exit gas costs, projected net yield over your intended holding period, break-even days, and historical risk metrics (Sharpe ratio, max drawdown, volatility) when available.

check_pool_viability — Before swapping on Uniswap V3, check whether the pool is deep enough for your trade. Returns a TVL-based impact assessment (negligible, low, moderate, or significant slippage risk), fee tier costs in USD, and 24-hour fee volume as an indicator of pool activity.

📊 ProfitLens — "What has historically worked?"#

ProfitLens is the empirical returns component. It computes real, measured returns from on-chain data — not theoretical APY projections. Returns are calculated from actual index ratio changes observed over time, giving agents a factual record of what each protocol and asset combination has actually delivered.

Tools in ProfitLens:

get_returns — Query historical returns by protocol, chain, asset, strategy (supply or borrow), and time window (7, 14, 30, or 90 days). Each result includes gross APY, net APY after gas, data completeness score, and risk metrics.

get_ranking — Ranked list of the best-performing strategies sorted by net APY. A quick way to see what's been working across the entire monitored ecosystem.

🚀 PreFlyte Intelligence — Coming Soon#

The third component — pre-execution transaction intelligence — is in development. This will answer: "Will this specific transaction lose money through ignorance?" It will analyse a proposed transaction before execution and flag issues like unfavourable slippage, excessive gas timing, rate model discontinuities, and position sizing problems. This is the component that gives the platform its name.

---

Coverage#

Protocols monitored: Aave V3, Compound V3, Uniswap V3, Lido

Chains: Ethereum mainnet, Arbitrum

Data sources: On-chain data collected directly via Alchemy and Infura RPC endpoints. Prices and TVL via DeFiLlama. No third-party data resellers.

Update frequency:

• Lending rates and risk parameters: every 10 minutes
• Gas prices: every 60 seconds
• Token prices: every 2 minutes
• Pool TVL and fees: every 30 minutes
• Computed returns: every 30 minutes

Coming soon:

• Base chain support (same protocols, next major addition)
• Optimism chain support
• 90-day return windows (data accumulating, expected June 2026)
• Historical accuracy tracking for verify_claim
• PreFlyte pre-execution intelligence (Phase 3)

---

Tool Reference#

Quick reference for all tool parameters. Every tool requires api_key as the first parameter.

ToolKey ParametersReturnsassess_opportunityasset, action, position_size_usd, strategyRanked opportunities with net APY, gas costs, anomaly flagsverify_claimclaim_type, value, operator, protocol, chain, assetTRUE/FALSE with actual value and deviationget_market_snapshotprotocol, chain, assetCurrent rates, risk params, price, gas, 7d contextgas_timingchainCurrent vs historical gas, cheapest hours, tx cost estimatescheck_entry_viabilityprotocol, chain, asset, actionViable true/false with reasons and capacity remainingestimate_net_positionprotocol, chain, asset, action, position_size_usdProjected yield, gas costs, break-even days, risk metricscheck_pool_viabilitychain, token_pair, trade_size_usdTVL-based impact, fee costs, pool activityget_returnschain, protocol, asset, strategy, window_daysHistorical returns with completeness and risk scoresget_rankingwindow_days, strategy, top_nRanked strategies by net APY

---

Constraints#

• Read-only data service — PreFlyte does not execute transactions or access wallets
• Lending and DEX coverage only — does not cover derivatives, prediction markets, bridges, or token launches
• Rates change continuously — projections are based on current and historical conditions, not guarantees
• Pool slippage is directional — trade impact assessment is based on TVL ratios, not exact tick-level concentrated liquidity calculations
• Compound V3 risk parameters are limited — some risk fields (pause flags, caps) return null due to contract access limitations

---

Rules#

• Always pass your PREFLYTE_API_KEY as the api_key parameter on every tool call
• Call assess_opportunity FIRST when waking up with new capital or changing strategy
• Call verify_claim BEFORE executing any trade based on rate assumptions
• Call gas_timing BEFORE transacting on Ethereum mainnet — gas varies 5x within a single day
• Do NOT treat projected returns as guaranteed
• Do NOT use PreFlyte as your only data source for critical financial decisions — cross-reference with on-chain data

---

About#

PreFlyte is built and operated from Ireland by an independent developer. All data is collected directly from on-chain sources. No third-party data resellers. No ads. No tracking beyond basic API usage counts.

Currently in free beta. Feedback welcome via GitHub.