{"uid":"cap_p_dVYfnqKFg8sZTWImgCt","slug":"vextorium-portfolio-valuation-0a753975","name":"Vextorium Portfolio Valuation","description":"Value a crypto portfolio such as {\"BTC\": 0.1, \"ETH\": 2}: current value and weight of each holding and total; with a start date, its value then, return, annualized volatility and maximum drawdown. Prices from DefiLlama.","url":"https://api.vextorium.com/v1/portfolio-valuation?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"positions":{"type":"object","description":"Ticker -> quantity (up to 20)"}}},"responseSchema":{"type":"json","example":{"date":"2026-10-16T21:12:44+00:00","source":"Data from alternative.me (Crypto API: free to use, including commercial projects; https://alternative.me/crypto/api/)","positions":[{"asset":"BTC","price":81564,"amount":0.1,"value_usd":8156.4,"weight_pct":62.85,"change_24h_pct":-0.6052},{"asset":"ETH","price":2410.9,"amount":2,"value_usd":4821.8,"weight_pct":37.15,"change_24h_pct":-1.68261}],"total_value_usd":12978.2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yxsEIk7JZH_z2QK5wxIrh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Values a multi-asset crypto portfolio by current prices and optionally computes historical performance metrics like return, volatility, and max drawdown since a given date.","exampleAgentPrompt":"What's my crypto portfolio worth right now and how has it performed since January 1st 2025? I hold 0.1 BTC and 2 ETH.","exampleUseCases":[{"title":"Daily crypto portfolio snapshot","prompt":"Give me a full valuation of my crypto holdings — I have 0.5 BTC, 3 ETH, and 500 SOL. Show me the USD value of each position and what percentage of my total portfolio each one represents."},{"title":"Year-to-date performance review","prompt":"How has my crypto portfolio done since January 1st 2025? I hold 0.25 BTC and 5 ETH — give me the total return, worst drawdown, and annualized volatility over that period."},{"title":"DeFi rebalancing decision support","prompt":"I'm thinking of rebalancing. Can you tell me the current value breakdown of my positions — 1000 USDC, 0.8 BTC, and 10 ETH — and show me which asset has the biggest weight so I know where to trim?"}],"resultDescription":"Returns a JSON object with per-asset breakdown (symbol, current price from DefiLlama aggregated feeds, quantity, USD value, and portfolio weight as a percentage), total portfolio USD value, and optionally a historical block with start date, total return percentage, maximum drawdown percentage, initial portfolio value, and annualized volatility percentage.","failureModes":["More than 20 positions submitted — API rejects with validation error","Unrecognized asset symbol — price cannot be fetched, position may be null or omitted","Invalid date format for 'since' field — historical block not returned or error","No price data available for an asset — null values in position output","Network timeout when fetching aggregated prices from DefiLlama"],"whenToPreferThis":"Use this endpoint when you need a complete multi-asset crypto portfolio valuation in a single call, especially when historical performance analytics (return, volatility, drawdown) are needed alongside current prices. Prefer it over individual price lookups when you have up to 20 assets and want portfolio-level metrics rather than just spot prices. Ideal for agents building portfolio dashboards, rebalancing tools, or performance reports.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T12:37:45.055Z","isFirstParty":false,"canonicalSlug":"vextorium-portfolio-valuation-0a753975"}