{"openapi":"3.1.0","info":{"title":"PreFlyte — DeFi Financial Intelligence for AI Agents","version":"2.0.0","description":"Empirical DeFi returns data and real-time market intelligence. PreFlyte answers \"is it smart?\" — where to deploy capital, verify market beliefs, assess gas timing, and check pool depth. Covers Aave V3, Compound V3, Uniswap V3, and Lido across Ethereum and Arbitrum.","x-guidance":"All endpoints use GET with query parameters. Payment is via MPP (HTTP 402 challenge-response). No API key or signup required — just pay per request.\n\nStart with GET /assess_opportunity to find where to deploy capital. Parameters: asset (e.g. USDC), action (supply/borrow), position_size_usd, strategy (yield_farming/active_trading/idle_capital).\n\nGET /market_snapshot returns current rates, risk params, price, gas for a specific market. Parameters: protocol (aave-v3/compound-v3), chain (ethereum/arbitrum), asset.\n\nGET /gas_timing tells you if now is a good time to transact. Parameter: chain.\n\nGET /verify_claim fact-checks market beliefs. Parameters: claim_type (supply_rate/borrow_rate/price/gas/utilization), value, operator (above/below/around), protocol, chain, asset.\n\nGET /profitlens/ranking returns ranked returns by net APY. Parameters: strategy, window, chain, position_size_usd, limit.\n\nGET /profitlens/returns queries historical returns. Parameters: chain, protocol, asset, strategy, window, position_size_usd.\n\nGET /check_entry_viability checks if a lending position is open. Parameters: protocol, chain, asset, action.\n\nGET /estimate_net_position projects net yield. Parameters: protocol, chain, asset, action, position_size_usd, duration_days.\n\nGET /check_pool_viability assesses Uniswap pool depth. Parameters: chain, token_pair (e.g. WETH/USDC), trade_size_usd."},"servers":[{"url":"https://pay.preflyte.xyz","description":"Production (USDC on Tempo mainnet)"}],"paths":{"/assess_opportunity":{"get":{"operationId":"assess_opportunity","summary":"Cold start orientation — where to deploy capital given position size and strategy","tags":["Intelligence"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.050000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string"},"description":"Token symbol, e.g. 'USDC', 'WETH'"},{"name":"action","in":"query","required":true,"schema":{"type":"string","enum":["supply","borrow"]},"description":"'supply' or 'borrow'"},{"name":"position_size_usd","in":"query","required":true,"schema":{"type":"number","minimum":0.01},"description":"Capital amount in USD"},{"name":"strategy","in":"query","required":true,"schema":{"type":"string","enum":["yield_farming","active_trading","idle_capital"]},"description":"Strategy mode"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"any"},"description":"'ethereum', 'arbitrum', or 'any'"},{"name":"trades_per_day","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"For active_trading only"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Parameters can also be sent as query string. This schema describes the inputs.","properties":{"asset":{"type":"string","description":"Token symbol, e.g. 'USDC'"},"action":{"type":"string","enum":["supply","borrow"]},"position_size_usd":{"type":"number","minimum":0.01},"strategy":{"type":"string","enum":["yield_farming","active_trading","idle_capital"]},"chain":{"type":"string","default":"any"},"trades_per_day":{"type":"integer","default":10}},"required":["asset","action","position_size_usd","strategy"]}}}},"responses":{"200":{"description":"Ranked opportunities with gas analysis and recommendation","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/profitlens/returns":{"get":{"operationId":"get_returns","summary":"Query historical DeFi lending returns","tags":["ProfitLens"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.010000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string"},"description":"'ethereum' or 'arbitrum'"},{"name":"protocol","in":"query","required":false,"schema":{"type":"string"},"description":"'aave-v3' or 'compound-v3'"},{"name":"asset","in":"query","required":false,"schema":{"type":"string"},"description":"Token symbol, e.g. 'USDC'"},{"name":"strategy","in":"query","required":false,"schema":{"type":"string","enum":["supply","borrow"]}},{"name":"window","in":"query","required":false,"schema":{"type":"integer","enum":[7,14,30,90],"default":7}},{"name":"position_size_usd","in":"query","required":false,"schema":{"type":"number"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"protocol":{"type":"string"},"asset":{"type":"string"},"strategy":{"type":"string","enum":["supply","borrow"]},"window":{"type":"integer","enum":[7,14,30,90]},"position_size_usd":{"type":"number"}}}}}},"responses":{"200":{"description":"Returns data with gross and net APY","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/profitlens/ranking":{"get":{"operationId":"get_ranking","summary":"Ranked list of best DeFi returns sorted by net APY","tags":["ProfitLens"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.010000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"strategy","in":"query","required":false,"schema":{"type":"string","enum":["supply","borrow"],"default":"supply"}},{"name":"window","in":"query","required":false,"schema":{"type":"integer","enum":[7,14,30,90],"default":7}},{"name":"chain","in":"query","required":false,"schema":{"type":"string"}},{"name":"position_size_usd","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"strategy":{"type":"string","enum":["supply","borrow"]},"window":{"type":"integer","enum":[7,14,30,90]},"chain":{"type":"string"},"position_size_usd":{"type":"number"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Ranked returns data","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/verify_claim":{"get":{"operationId":"verify_claim","summary":"Verify factual claims about current DeFi market conditions","tags":["RealityCheck"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.010000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"claim_type","in":"query","required":false,"schema":{"type":"string","enum":["supply_rate","borrow_rate","price","gas","utilization"]}},{"name":"value","in":"query","required":false,"schema":{"type":"number"}},{"name":"operator","in":"query","required":false,"schema":{"type":"string","enum":["above","below","around"],"default":"above"}},{"name":"protocol","in":"query","required":false,"schema":{"type":"string"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"ethereum"}},{"name":"asset","in":"query","required":false,"schema":{"type":"string"}},{"name":"claims","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"claim_type":{"type":"string","enum":["supply_rate","borrow_rate","price","gas","utilization"]},"value":{"type":"number"},"operator":{"type":"string","enum":["above","below","around"]},"protocol":{"type":"string"},"chain":{"type":"string"},"asset":{"type":"string"},"claims":{"type":"string","description":"JSON array for batch mode"}}}}}},"responses":{"200":{"description":"Verification result with TRUE/FALSE status, actual value, and delta","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/market_snapshot":{"get":{"operationId":"market_snapshot","summary":"Current market state: rates, risk params, price, gas, and anomaly detection","tags":["RealityCheck"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.020000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"protocol","in":"query","required":true,"schema":{"type":"string"},"description":"'aave-v3' or 'compound-v3'"},{"name":"chain","in":"query","required":true,"schema":{"type":"string"},"description":"'ethereum' or 'arbitrum'"},{"name":"asset","in":"query","required":true,"schema":{"type":"string"},"description":"Token symbol"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"protocol":{"type":"string"},"chain":{"type":"string"},"asset":{"type":"string"}},"required":["protocol","chain","asset"]}}}},"responses":{"200":{"description":"Complete market snapshot with lending rates, risk params, price, gas, and 7-day context","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/gas_timing":{"get":{"operationId":"gas_timing","summary":"Is now a good time to transact? Current gas vs historical averages","tags":["RealityCheck"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.010000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"chain","in":"query","required":true,"schema":{"type":"string"},"description":"'ethereum' or 'arbitrum'"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string","description":"'ethereum' or 'arbitrum'"}},"required":["chain"]}}}},"responses":{"200":{"description":"Gas timing assessment with cheapest hours and reference costs","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/check_entry_viability":{"get":{"operationId":"check_entry_viability","summary":"Can I enter this lending position? Cap checks, frozen/inactive detection","tags":["RealityCheck"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.020000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"protocol","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","required":true,"schema":{"type":"string"}},{"name":"asset","in":"query","required":true,"schema":{"type":"string"}},{"name":"action","in":"query","required":true,"schema":{"type":"string","enum":["supply","borrow"]}},{"name":"amount_usd","in":"query","required":false,"schema":{"type":"number","default":0}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"protocol":{"type":"string"},"chain":{"type":"string"},"asset":{"type":"string"},"action":{"type":"string","enum":["supply","borrow"]},"amount_usd":{"type":"number"}},"required":["protocol","chain","asset","action"]}}}},"responses":{"200":{"description":"Viability verdict with market status, capacity, and rate","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/estimate_net_position":{"get":{"operationId":"estimate_net_position","summary":"Detailed net yield projection with gas costs and break-even days","tags":["RealityCheck"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.030000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"protocol","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","required":true,"schema":{"type":"string"}},{"name":"asset","in":"query","required":true,"schema":{"type":"string"}},{"name":"action","in":"query","required":true,"schema":{"type":"string","enum":["supply","borrow"]}},{"name":"position_size_usd","in":"query","required":true,"schema":{"type":"number","minimum":0.01}},{"name":"duration_days","in":"query","required":false,"schema":{"type":"integer","default":30}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"protocol":{"type":"string"},"chain":{"type":"string"},"asset":{"type":"string"},"action":{"type":"string","enum":["supply","borrow"]},"position_size_usd":{"type":"number","minimum":0.01},"duration_days":{"type":"integer","default":30}},"required":["protocol","chain","asset","action","position_size_usd"]}}}},"responses":{"200":{"description":"Position estimate with projected return, gas breakdown, and historical context","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/check_pool_viability":{"get":{"operationId":"check_pool_viability","summary":"Uniswap V3 pool depth assessment — TVL, trade impact, fee tier comparison","tags":["RealityCheck"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.020000","currency":"USD"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"name":"chain","in":"query","required":true,"schema":{"type":"string"}},{"name":"token_pair","in":"query","required":true,"schema":{"type":"string"},"description":"e.g. 'WETH/USDC'"},{"name":"trade_size_usd","in":"query","required":true,"schema":{"type":"number","minimum":0.01}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"token_pair":{"type":"string","description":"e.g. 'WETH/USDC'"},"trade_size_usd":{"type":"number","minimum":0.01}},"required":["chain","token_pair","trade_size_usd"]}}}},"responses":{"200":{"description":"Pool viability with TVL, trade impact, fees, and recommendation","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}}}}