{"openapi":"3.1.0","info":{"title":"yieldprobe","version":"0.2.0","description":"Real-time DeFi intelligence for AI agents: top yields, APY anomalies, stablecoin peg monitor, token contract risk. Pay per call in USDC on Base via x402. Every response is timestamped and EIP-712 signed.","guidance":"yieldprobe sells live DeFi data. Each call costs $0.002-0.003 in USDC on Base; responses are { data, meta } where meta.asOfIso is the snapshot time and meta.attestation is an EIP-712 signature over the data.\nPick the endpoint by intent:\n- Where to earn yield: GET /v1/yields. Filter with chain (Ethereum, Base, Arbitrum, Solana...), stable=true for stablecoin pools, minTvl (USD, default 1e6), project (e.g. aave-v3), limit (default 20). Prefer pools with low sigma and a forecast of Stable/Up; apyMean30d is steadier than the spot apy.\n- What changed today: GET /v1/yields/movers?window=1d (or 7d). Returns up and down lists, 10 each by default. A sudden APY spike on a large pool often means incentives or a liquidity exit; check token risk before recommending it.\n- Is a stablecoin safe: GET /v1/stables/peg. Returns every depegged coin (deviation >= threshold, default 0.005) plus the 20 largest by supply with 1d/7d supply change. Call this before recommending any stablecoin yield. full=true returns all ~120 coins (large).\n- Is a token contract dangerous: GET /v1/token/{chainId}/{address}/security with chainId in 1, 56, 137, 42161, 8453, 10, 43114. Returns riskScore 0-100 (higher is safer) and a risks list (honeypot, high_sell_tax, mintable, proxy_upgradeable, owner_can_change_balance...). Treat honeypot or cannot_sell_all as a hard stop.\nTypical flow for 'find me a safe stablecoin yield on Base': /v1/stables/peg, then /v1/yields?chain=Base&stable=true, then /v1/token/8453/{address}/security for any unfamiliar underlying token. Three calls, under $0.01 total.\nData older than 15 minutes should be refreshed. Retrying a paid request with the same payment-identifier after a network error is free. The same tools are also available as a paid remote MCP server at /mcp.","x-guidance":"yieldprobe sells live DeFi data. Each call costs $0.002-0.003 in USDC on Base; responses are { data, meta } where meta.asOfIso is the snapshot time and meta.attestation is an EIP-712 signature over the data.\nPick the endpoint by intent:\n- Where to earn yield: GET /v1/yields. Filter with chain (Ethereum, Base, Arbitrum, Solana...), stable=true for stablecoin pools, minTvl (USD, default 1e6), project (e.g. aave-v3), limit (default 20). Prefer pools with low sigma and a forecast of Stable/Up; apyMean30d is steadier than the spot apy.\n- What changed today: GET /v1/yields/movers?window=1d (or 7d). Returns up and down lists, 10 each by default. A sudden APY spike on a large pool often means incentives or a liquidity exit; check token risk before recommending it.\n- Is a stablecoin safe: GET /v1/stables/peg. Returns every depegged coin (deviation >= threshold, default 0.005) plus the 20 largest by supply with 1d/7d supply change. Call this before recommending any stablecoin yield. full=true returns all ~120 coins (large).\n- Is a token contract dangerous: GET /v1/token/{chainId}/{address}/security with chainId in 1, 56, 137, 42161, 8453, 10, 43114. Returns riskScore 0-100 (higher is safer) and a risks list (honeypot, high_sell_tax, mintable, proxy_upgradeable, owner_can_change_balance...). Treat honeypot or cannot_sell_all as a hard stop.\nTypical flow for 'find me a safe stablecoin yield on Base': /v1/stables/peg, then /v1/yields?chain=Base&stable=true, then /v1/token/8453/{address}/security for any unfamiliar underlying token. Three calls, under $0.01 total.\nData older than 15 minutes should be refreshed. Retrying a paid request with the same payment-identifier after a network error is free. The same tools are also available as a paid remote MCP server at /mcp."},"servers":[{"url":"https://yieldprobe.com"}],"tags":[{"name":"x402"},{"name":"defi"}],"x-agentcash-provenance":{"ownershipProofs":["0xebfbf79bb61711826218389dc14dcebca5a6a9f548b203ca89e2cde0f91ac07272fa073d240b7f447c6f85a2a168bb4b4258d8ea8f89c95edb1ba28a5bd7b0ec1b"],"payTo":["0xF74E262d2472528Ba7Fa19BDE6d9FbcC088796c3"]},"x-discovery":{"ownershipProofs":["0xebfbf79bb61711826218389dc14dcebca5a6a9f548b203ca89e2cde0f91ac07272fa073d240b7f447c6f85a2a168bb4b4258d8ea8f89c95edb1ba28a5bd7b0ec1b"]},"paths":{"/v1/yields":{"get":{"operationId":"v1_yields","summary":"Top pools by APY, filterable","tags":["x402","defi"],"parameters":[{"name":"chain","in":"query","description":"Chain name, e.g. Ethereum, Base, Arbitrum, Solana","required":false,"schema":{"type":"string"}},{"name":"project","in":"query","description":"Protocol slug, e.g. aave-v3, morpho, lido","required":false,"schema":{"type":"string"}},{"name":"stable","in":"query","description":"Only stablecoin pools","required":false,"schema":{"type":"string","enum":["true","false"]}},{"name":"symbol","in":"query","description":"Substring match on pool symbol","required":false,"schema":{"type":"string"}},{"name":"minTvl","in":"query","description":"Minimum TVL in USD, default 1000000","required":false,"schema":{"type":"string"}},{"name":"maxSigma","in":"query","description":"Max APY volatility","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"1..100, default 20","required":false,"schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","payTo":"0xF74E262d2472528Ba7Fa19BDE6d9FbcC088796c3"}}]},"responses":{"200":{"description":"Signed JSON { data, meta }","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","properties":{"asOf":{"type":"integer"},"asOfIso":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"attestation":{"type":"object"}}}}}}}},"402":{"description":"Payment required (x402 v2). Read the PAYMENT-REQUIRED header."}}}},"/v1/yields/movers":{"get":{"operationId":"v1_yields_movers","summary":"Largest APY moves 1d/7d","tags":["x402","defi"],"parameters":[{"name":"chain","in":"query","description":"Chain name","required":false,"schema":{"type":"string"}},{"name":"window","in":"query","description":"Change window","required":false,"schema":{"type":"string","enum":["1d","7d"]}},{"name":"minTvl","in":"query","description":"Minimum TVL in USD, default 5000000","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Pools per side, 1..100, default 10","required":false,"schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","payTo":"0xF74E262d2472528Ba7Fa19BDE6d9FbcC088796c3"}}]},"responses":{"200":{"description":"Signed JSON { data, meta }","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","properties":{"asOf":{"type":"integer"},"asOfIso":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"attestation":{"type":"object"}}}}}}}},"402":{"description":"Payment required (x402 v2). Read the PAYMENT-REQUIRED header."}}}},"/v1/stables/peg":{"get":{"operationId":"v1_stables_peg","summary":"Stablecoin peg + supply monitor","tags":["x402","defi"],"parameters":[{"name":"threshold","in":"query","description":"Abs deviation from 1.0 to flag, default 0.005","required":false,"schema":{"type":"string"}},{"name":"minCirculating","in":"query","description":"USD floor, default 10000000","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Largest stablecoins to include, 1..200, default 20","required":false,"schema":{"type":"string"}},{"name":"full","in":"query","description":"Return every tracked stablecoin","required":false,"schema":{"type":"string","enum":["true","false"]}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","payTo":"0xF74E262d2472528Ba7Fa19BDE6d9FbcC088796c3"}}]},"responses":{"200":{"description":"Signed JSON { data, meta }","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","properties":{"asOf":{"type":"integer"},"asOfIso":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"attestation":{"type":"object"}}}}}}}},"402":{"description":"Payment required (x402 v2). Read the PAYMENT-REQUIRED header."}}}},"/v1/token/{chainId}/{address}/security":{"get":{"operationId":"v1_token_chainId_address_security","summary":"Token risk score","tags":["x402","defi"],"parameters":[{"name":"chainId","in":"path","description":"EVM chain id","required":true,"schema":{"type":"string","enum":["1","56","137","42161","8453","10","43114"]}},{"name":"address","in":"path","description":"Token contract address","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","payTo":"0xF74E262d2472528Ba7Fa19BDE6d9FbcC088796c3"}}]},"responses":{"200":{"description":"Signed JSON { data, meta }","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","properties":{"asOf":{"type":"integer"},"asOfIso":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"attestation":{"type":"object"}}}}}}}},"402":{"description":"Payment required (x402 v2). Read the PAYMENT-REQUIRED header."}}}}}}