# Virae Strategy Simulation Matrix API

> Virae Strategy Simulation Matrix API is a paid API for AI agents from api.virae.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a paginated, sortable simulation matrix for a given Virae prediction-market strategy, including normalized PnL curves and coverage metadata.

## Facts

- Endpoint: GET https://api.virae.ai/api/x402/v1/simulations/:strategyKey/matrix
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/virae-strategy-simulation-matrix-api-f5f0cdc8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VUVMTEDMnJt_vbWd4fpBC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability virae-strategy-simulation-matrix-api-f5f0cdc8
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Query a paginated, sortable Virae strategy simulation matrix with normalized PnL curves and coverage metadata.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/virae-strategy-simulation-matrix-api-f5f0cdc8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.virae.ai](https://www.zero.xyz/host/api.virae.ai/llms.txt)