{
  "opencollection": "1.0.0",
  "info": {
    "name": "Octav Airdrops Virtual Users API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Virtual Users",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Virtual Users",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.octav.fi/v1/virtual-users",
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "List all virtual users belonging to the authenticated API user. Requires a Pro subscription — virtual users are created in the [Octav Pro](https://pro.octav.fi) app.\n\n**Cost:** 1 credit per call\n\n**Get your API key:** [Dev Portal](https://data.octav.fi)"
        },
        {
          "info": {
            "name": "Virtual Users Portfolio",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.octav.fi/v1/virtual-users/portfolio",
            "params": [
              {
                "name": "addresses",
                "value": "virtual:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                "type": "query",
                "description": "Comma-separated virtual user addresses (from the list endpoint). Format: virtual:<id>. Max 10."
              },
              {
                "name": "aggregated",
                "value": "",
                "type": "query",
                "description": "Return a single reduced portfolio across all virtual users"
              },
              {
                "name": "waitForSync",
                "value": "",
                "type": "query",
                "description": "Wait for fresh data if cache is stale"
              },
              {
                "name": "includeImages",
                "value": "",
                "type": "query",
                "description": "Include image URLs for chains, assets, and protocols"
              },
              {
                "name": "includeExplorerUrls",
                "value": "",
                "type": "query",
                "description": "Include blockchain explorer URLs for assets and transactions"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Fetch portfolios for one or more virtual users. Works identically to GET /portfolio but uses virtual user addresses. Requires a Pro subscription.\n\n**Cost:** 1 credit per virtual user address\n\n**Get your API key:** [Dev Portal](https://data.octav.fi)"
        }
      ]
    }
  ],
  "bundled": true
}