{"uid":"cap_VUVMTEDMnJt_vbWd4fpBC","slug":"virae-strategy-simulation-matrix-api-f5f0cdc8","name":"Virae Strategy Simulation Matrix API","description":"Query a paginated, sortable Virae strategy simulation matrix with normalized PnL curves and coverage metadata.","url":"https://api.virae.ai/api/x402/v1/simulations/:strategyKey/matrix","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["strategyKey"],"properties":{"strategyKey":{"type":"string"}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"page":{"type":"integer","default":1,"minimum":1},"pnlMode":{"enum":["strategy","afterFees"],"type":"string","default":"afterFees"},"sortKey":{"enum":["parameter","netPnl","winRate","fillRate","settled","invested"],"type":"string"},"pageSize":{"type":"integer","default":20,"maximum":100,"minimum":1},"curveRange":{"enum":["7d","30d","90d","all"],"type":"string","default":"30d"},"sortDirection":{"enum":["asc","desc"],"type":"string","default":"desc"},"curveConfigIds":{"type":"string","description":"Comma-separated positive configuration ids; at most 5."},"displayNotionalUsd":{"type":"number","default":100,"maximum":100000,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","schemaVersion"],"properties":{"ok":{"type":"boolean"},"schemaVersion":{"type":"string"}},"additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__OHQtRw_LWuNsJtQSWo27","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated, sortable simulation matrix for a given Virae prediction-market strategy, including normalized PnL curves and coverage metadata.","exampleAgentPrompt":"Pull the Virae simulation matrix for strategy 'btc-momentum-v2', sorted by net PnL descending, showing after-fees PnL curves over the last 30 days, page 1 with 20 results.","exampleUseCases":[{"title":"Top strategies by net PnL","prompt":"Show me the first page of the Virae simulation matrix for strategy 'eth-arb-v1', sorted by net PnL descending with after-fees mode and a 30-day curve range — give me 20 results."},{"title":"Long-term performance review","prompt":"I want to review strategy 'polymarket-sports-spreads' on Virae over all time — pull the simulation matrix sorted by win rate descending, after fees, page 1."},{"title":"Compare specific config IDs","prompt":"Fetch the Virae simulation matrix for strategy 'crypto-copy-v3', filter to config IDs 12,15,18, sorted by fill rate descending over a 90-day curve range, and assume a notional of $5000."}],"resultDescription":"A paginated JSON object containing a simulation matrix for the specified strategy. Each row includes normalized PnL curve data (strategy or after-fees), win rate, fill rate, settled trade count, invested amount, and net PnL. The response also includes coverage metadata and a schema version indicator.","failureModes":["Invalid or unknown strategyKey returns a 404 or empty result set","More than 5 curveConfigIds supplied returns a validation error","pageSize exceeding 100 returns a schema validation error","displayNotionalUsd of 0 or negative returns a validation error","Invalid sortKey or pnlMode enum value returns a 400 bad request","Payment not provided or insufficient USDC balance returns a 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need structured, paginated simulation performance data for a specific Virae prediction-market strategy, especially when you want to compare parameter configurations by PnL, win rate, or fill rate across configurable time windows. Prefer this over generic market data APIs when the user is analyzing Virae-specific strategy simulations with normalized PnL curves.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:57.858Z","isFirstParty":false}