{"uid":"cap__vWn7q5OEdM4P3I3CF0xa","slug":"blockrun-defi-protocol-metrics-5d1fff55","name":"BlockRun DeFi Protocol Metrics","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/surf/project/defi/metrics","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"metric":{"type":"string","description":"Required query param"}}},"responseSchema":null,"example":{"request":{"id":"aave","metric":"tvl"},"response":{"data":[{"value":22803790019.164825,"timestamp":1781568000},{"value":22600349835.268074,"timestamp":1781481600},{"value":22068124547.181217,"timestamp":1781395200},{"value":21583654342.955345,"timestamp":1781308800},{"value":21472234032.69445,"timestamp":1781222400},{"value":21423556845.087597,"timestamp":1781136000},{"value":20938490878.934593,"timestamp":1781049600},{"value":20976458695.922306,"timestamp":1780963200},{"value":21474183233.361874,"timestamp":1780876800},{"value":21470121104.054768,"timestamp":1780790400},{"value":20619020209.129173,"timestamp":1780704000},{"value":20776361768.67728,"timestamp":1780617600},{"value":21831036665.904278,"timestamp":1780531200},{"value":22148113773.61236,"timestamp":1780444800},{"value":22585257260.188793,"timestamp":1780358400},{"value":23578656886.458096,"timestamp":1780272000},{"value":23823117207.665363,"timestamp":1780185600},{"value":23852910824.880703,"timestamp":1780099200},{"value":23737100071.176743,"timestamp":1780012800},{"value":23690430047.186554,"timestamp":1779926400}],"meta":{"limit":20,"total":2025,"cached":false,"offset":0,"has_more":true,"credits_used":1},"$schema":"https://api.asksurf.ai/schemas/DataResponseProjectMetricPoint.json"}},"exampleRequest":{"id":"aave","metric":"tvl"},"tags":["x402"],"displayCostAmount":"0.0075","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0075/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wMWq8qz4K8QgrWKPsPnSG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-protocol DeFi metrics including TVL, fees, and revenue for a given metric type.","exampleAgentPrompt":"What's the current TVL metric for DeFi protocols? Pull the latest per-protocol DeFi metrics from BlockRun.","exampleUseCases":null,"resultDescription":"Returns structured DeFi metrics data broken down per protocol, including total value locked (TVL), fees generated, and revenue figures for the requested metric type.","failureModes":["Missing required 'metric' query parameter returns an error","Invalid metric name returns no data or an error response","Payment not settled results in 402 Payment Required","Rate limiting or network issues may cause timeout","Unsupported metric type may return empty results"],"whenToPreferThis":"Use this endpoint when you need granular, per-protocol DeFi financial metrics such as TVL, fees, or revenue on a pay-per-call basis without needing a long-term API subscription. Ideal for agents that need on-demand DeFi analytics settled in USDC on Base via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:51:11.688Z","isFirstParty":false}