Vaults

Get combined vault-level and substrategy analytics for a vault

Changed on

Returns the vault-level analytics row plus per-substrategy analytics rows for a single vault. vault_level is null when the vault has no analytics blob yet; substrategies only contains entries whose Redis blob is present. 404 only when the vault itself does not exist — missing analytics data returns 200 with empty fields.

get/vaults/analytics

Request

  • Base URL
    https://api.prod.paradex.trade/v1
  • URL
    https://api.prod.paradex.trade/v1/vaults/analytics
  • Auth
    none declared

Query parameters

addressstring required

Vault address

Response

OK

addressstring
as_ofstring

Example response

{
  "address": "0x1234567890abcdef",
  "as_of": "2026-05-05 09:00:00.000",
  "substrategies": [
    {
      "account_address": "0x1234567890abcdef",
      "cumulative_pnl_series": [
        {
          "day": "2026-05-05",
          "value": "1234.56"
        }
      ],
      "hourly_cumulative_pnl_series": [
        {
          "at": "2026-05-05 09:00:00.000",
          "value": "1234.56"
        }
      ],
      "monthly_pnl_last_12m": [
        {
          "month": "2026-05-01",
          "month_return_canonical": "0.0123"
        }
      ],
      "strategy_name": "Spot LP"
    }
  ],
  "vault_level": {
    "address": "0x1234567890abcdef",
    "as_of": "2026-05-05 09:00:00.000",
    "monthly_pnl_last_12m": [
      {
        "month": "2026-05-01",
        "month_return_pct": "0.0123"
      }
    ],
    "top_holders": [
      {
        "percentage": "24.6371578053709186",
        "rank": 1,
        "value_usdc": "3758808.50501487823"
      }
    ]
  }
}

Changes

  • f33feb7333eaRevision changes
    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

  • 72c125c93c2bRevision changes
    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status