{"uid":"cap_7b3zARdDFVs42Yg_8OTEq","slug":"api-messari-io-0a7e8000","name":"Messari ROI Snapshots","description":"Get multi-window ROI snapshots for one or more cryptocurrency assets.","url":"https://api.messari.io/metrics/v2/assets/roi?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"ids":{"type":"string","description":"Comma-separated asset ids."},"tags":{"type":"array","items":{"type":"string"}},"limit":{"type":"integer","minimum":1},"slugs":{"type":"string","description":"Comma-separated asset slugs."},"search":{"type":"string"},"sector":{"type":"string"},"category":{"type":"string"}}},"responseSchema":{"example":{"data":[{"id":"btc","roi_30d":0}]}},"example":{"request":{"ids":"bitcoin,ethereum,solana","limit":10},"response":{"data":[{"id":"1e31218a-e44e-4285-820c-8282ee222035","name":"Bitcoin","slug":"bitcoin","tags":["Proof-of-Work"],"sector":"Cryptocurrency","symbol":"BTC","category":"Cryptocurrency","returnOnInvestment":{"priceChange1y":-39.94478882999572,"priceChange3y":124.01968845637299,"priceChange5y":70.32977096506198,"priceChange7d":-16.867399382820405,"priceChange24h":-4.395498506325786,"priceChange30d":-25.059571730245306,"priceChangeMTD":-17.12587780926275,"priceChangeQTD":-10.564213693894889,"priceChangeYTD":-30.26058265930714}},{"id":"b3d5d66c-26a2-404c-9325-91dc714a722b","name":"Solana","slug":"solana","tags":["Proof-of-Stake","SEC Alleged Securities","Stakeable"],"sector":"Smart Contract Platform","symbol":"SOL","category":"Networks","returnOnInvestment":{"priceChange1y":-55.9281416217026,"priceChange3y":212.000670744265,"priceChange5y":50.67665894107235,"priceChange7d":-22.342028194818127,"priceChange24h":-7.512129317376055,"priceChange30d":-28.601570027232142,"priceChangeMTD":-22.748001235886765,"priceChangeQTD":-23.43415145971812,"priceChangeYTD":-48.85477918535833}},{"id":"21c795f5-1bfd-40c3-858e-e9d7e820c6d0","name":"Ethereum","slug":"ethereum","tags":["EVM","Proof-of-Stake","Stakeable"],"sector":"Smart Contract Platform","symbol":"ETH","category":"Networks","returnOnInvestment":{"priceChange1y":-34.71549442668137,"priceChange3y":-16.281479699837362,"priceChange5y":-41.838721792264145,"priceChange7d":-21.61553584318943,"priceChange24h":-10.841531959414963,"priceChange30d":-32.88690936224126,"priceChangeMTD":-21.350787974299873,"priceChangeQTD":-25.038428646377398,"priceChangeYTD":-46.81774450149017}}],"error":null,"metadata":{"page":1,"pageSize":10,"totalRows":3,"totalPages":1}}},"exampleRequest":{"ids":"bitcoin,ethereum,solana","limit":10},"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NmXfkRiLl84ZQHZ4hDLLA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns multi-window return-on-investment (ROI) snapshots for one or more cryptocurrency assets.","exampleAgentPrompt":"Pull Messari ROI snapshots for bitcoin, ethereum, and solana — I want to see their multi-window return performance side by side.","exampleUseCases":null,"resultDescription":"Returns a set of ROI data objects for each requested asset, containing return percentages across multiple time windows (e.g. 1d, 7d, 30d, 1y, etc.), keyed by asset id or slug.","failureModes":["Invalid or unknown asset ids/slugs return empty results or 404","Comma-separated ids/slugs with spaces or formatting errors may cause parse failures","Exceeding rate limits or quota returns 429 or payment-required response","No matching assets for given sector/category/search filter returns empty list","Payment not fulfilled (x402) results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need multi-window ROI performance data for one or more crypto assets by id or slug. Prefer this over the general asset snapshot endpoint when the specific focus is investment return percentages across time periods rather than broad asset metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:40:19.158Z","isFirstParty":false,"canonicalSlug":"api-messari-io-0a7e8000"}