{
  "x402Version": 2,
  "id": 26997,
  "slug": "26997",
  "resource": "https://api.vaults.fyi/v2/portfolio/positions/:userAddress",
  "description": "Provides all vault positions for the user, with optional filters.",
  "type": "http",
  "serviceName": "vaults.fyi",
  "resourceType": "Market Data",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x108BCd8a07C3fdfca3Aa500784A8573123a1029F",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 60
    },
    {
      "scheme": "batch-settlement",
      "network": "eip155:8453",
      "payTo": "0x108BCd8a07C3fdfca3Aa500784A8573123a1029F",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "properties": {
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "headers": {
            "x-402-auth": "true"
          },
          "method": "GET",
          "pathParams": {
            "userAddress": "0x3f58B55236065b40583BC41dD46ab6F0E7726EC0"
          },
          "queryParams": {
            "allowedNetworks": [
              "base",
              "mainnet",
              "arbitrum",
              "optimism"
            ],
            "apyInterval": "7day",
            "minTvl": 100000,
            "minUsdAssetValueThreshold": 1
          },
          "type": "http"
        },
        "output": {
          "type": "json"
        }
      },
      "routeTemplate": "/v2/portfolio/positions/:userAddress",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "properties": {
              "headers": {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "pathParams": {
                "type": "object"
              },
              "queryParams": {
                "additionalProperties": false,
                "properties": {
                  "allowCorrupted": {
                    "default": false,
                    "description": "Allow inclusion of corrupted vaults.",
                    "type": "boolean"
                  },
                  "allowVaultsWithWarnings": {
                    "description": "Whether to include vaults with warnings. Defaults to true.",
                    "type": "boolean"
                  },
                  "allowedAssets": {
                    "description": "Assets to be included by symbol(ticker).",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "allowedNetworks": {
                    "default": [
                      "base",
                      "mainnet",
                      "arbitrum",
                      "optimism"
                    ],
                    "description": "Networks to be included (name or CAIP).",
                    "items": {
                      "description": "Include only vaults with provided network(name or CAIP)",
                      "enum": [
                        "mainnet",
                        "optimism",
                        "arbitrum",
                        "polygon",
                        "gnosis",
                        "base",
                        "unichain",
                        "swellchain",
                        "celo",
                        "worldchain",
                        "berachain",
                        "ink",
                        "bsc",
                        "hyperliquid",
                        "plasma",
                        "avalanche",
                        "katana",
                        "linea",
                        "mega-eth",
                        "monad",
                        "etherlink",
                        "robinhood",
                        "eip155:1",
                        "eip155:10",
                        "eip155:42161",
                        "eip155:137",
                        "eip155:100",
                        "eip155:8453",
                        "eip155:130",
                        "eip155:1923",
                        "eip155:42220",
                        "eip155:480",
                        "eip155:80094",
                        "eip155:57073",
                        "eip155:56",
                        "eip155:999",
                        "eip155:9745",
                        "eip155:43114",
                        "eip155:747474",
                        "eip155:59144",
                        "eip155:4326",
                        "eip155:143",
                        "eip155:42793",
                        "eip155:4663"
                      ],
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "allowedProtocols": {
                    "description": "Protocols to be included by protocol ID or name.",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "apyInterval": {
                    "default": "7day",
                    "description": "Interval for APY data. Possible values: 1day, 7day, 30day",
                    "enum": [
                      "1day",
                      "7day",
                      "30day"
                    ],
                    "type": "string"
                  },
                  "curators": {
                    "description": "Curators to be included.",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "disallowedAssets": {
                    "description": "Assets to be excluded by symbol(ticker). The parameter is ignored if \"allowedAssets\" is specified.",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "disallowedNetworks": {
                    "description": "Networks to be excluded (name or CAIP). The parameter is ignored if \"allowedNetworks\" is specified.",
                    "items": {
                      "description": "Include only vaults with provided network(name or CAIP)",
                      "enum": [
                        "mainnet",
                        "optimism",
                        "arbitrum",
                        "polygon",
                        "gnosis",
                        "base",
                        "unichain",
                        "swellchain",
                        "celo",
                        "worldchain",
                        "berachain",
                        "ink",
                        "bsc",
                        "hyperliquid",
                        "plasma",
                        "avalanche",
                        "katana",
                        "linea",
                        "mega-eth",
                        "monad",
                        "etherlink",
                        "robinhood",
                        "eip155:1",
                        "eip155:10",
                        "eip155:42161",
                        "eip155:137",
                        "eip155:100",
                        "eip155:8453",
                        "eip155:130",
                        "eip155:1923",
                        "eip155:42220",
                        "eip155:480",
                        "eip155:80094",
                        "eip155:57073",
                        "eip155:56",
                        "eip155:999",
                        "eip155:9745",
                        "eip155:43114",
                        "eip155:747474",
                        "eip155:59144",
                        "eip155:4326",
                        "eip155:143",
                        "eip155:42793",
                        "eip155:4663"
                      ],
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "disallowedProtocols": {
                    "description": "Protocols to be excluded by protocol ID or name. The parameter is ignored if \"allowedProtocols\" is specified.",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "maxApy": {
                    "description": "Maximum APY (in decimal) of the vaults to be included",
                    "type": "number"
                  },
                  "maxTvl": {
                    "description": "Maximum TVL in USD of the vaults to be included",
                    "type": "integer"
                  },
                  "minApy": {
                    "description": "Minimum APY (in decimal) of the vaults to be included",
                    "type": "number"
                  },
                  "minTvl": {
                    "default": 100000,
                    "description": "Minimum TVL in USD of the vaults to be included",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "minUsdAssetValueThreshold": {
                    "default": 1,
                    "description": "Minimum USD value of the vault to be included",
                    "minimum": 0,
                    "type": "number"
                  },
                  "minVaultScore": {
                    "description": "Minimum vault score required for a vault to be included",
                    "minimum": 0,
                    "type": "number"
                  },
                  "onlyAppFeatured": {
                    "description": "Include only vaults that are featured in app.vaults.fyi",
                    "type": "boolean"
                  },
                  "onlyTransactional": {
                    "description": "Include only vaults that are supported in the transactional interface.",
                    "type": "boolean"
                  },
                  "sortBy": {
                    "description": "Field to sort by.",
                    "enum": [
                      "balanceUsd",
                      "tvl",
                      "apy1Day",
                      "apy7Day",
                      "apy30Day"
                    ],
                    "type": "string"
                  },
                  "sortOrder": {
                    "default": "asc",
                    "description": "Sort order, either asc or desc. Ascending is default.",
                    "enum": [
                      "asc",
                      "desc"
                    ],
                    "type": "string"
                  },
                  "tags": {
                    "description": "Tags to be included.",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "type": "array"
                  }
                },
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "defi",
    "vaults",
    "yield",
    "analytics",
    "bazaar"
  ],
  "sourceHost": "api.vaults.fyi",
  "lastUpdated": "2026-10-09T23:21:13.323Z",
  "quality": {
    "calls30d": 10,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-09T23:21:22.61Z"
  },
  "metadata": {
    "serviceName": "vaults.fyi",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "headers": {
              "x-402-auth": "true"
            },
            "method": "GET",
            "pathParams": {
              "userAddress": "0x3f58B55236065b40583BC41dD46ab6F0E7726EC0"
            },
            "queryParams": {
              "allowedNetworks": [
                "base",
                "mainnet",
                "arbitrum",
                "optimism"
              ],
              "apyInterval": "7day",
              "minTvl": 100000,
              "minUsdAssetValueThreshold": 1
            },
            "type": "http"
          },
          "output": {
            "type": "json"
          }
        },
        "routeTemplate": "/v2/portfolio/positions/:userAddress",
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "properties": {
                "headers": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "type": "object"
                },
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "pathParams": {
                  "type": "object"
                },
                "queryParams": {
                  "additionalProperties": false,
                  "properties": {
                    "allowCorrupted": {
                      "default": false,
                      "description": "Allow inclusion of corrupted vaults.",
                      "type": "boolean"
                    },
                    "allowVaultsWithWarnings": {
                      "description": "Whether to include vaults with warnings. Defaults to true.",
                      "type": "boolean"
                    },
                    "allowedAssets": {
                      "description": "Assets to be included by symbol(ticker).",
                      "items": {
                        "minLength": 1,
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "allowedNetworks": {
                      "default": [
                        "base",
                        "mainnet",
                        "arbitrum",
                        "optimism"
                      ],
                      "description": "Networks to be included (name or CAIP).",
                      "items": {
                        "description": "Include only vaults with provided network(name or CAIP)",
                        "enum": [
                          "mainnet",
                          "optimism",
                          "arbitrum",
                          "polygon",
                          "gnosis",
                          "base",
                          "unichain",
                          "swellchain",
                          "celo",
                          "worldchain",
                          "berachain",
                          "ink",
                          "bsc",
                          "hyperliquid",
                          "plasma",
                          "avalanche",
                          "katana",
                          "linea",
                          "mega-eth",
                          "monad",
                          "etherlink",
                          "robinhood",
                          "eip155:1",
                          "eip155:10",
                          "eip155:42161",
                          "eip155:137",
                          "eip155:100",
                          "eip155:8453",
                          "eip155:130",
                          "eip155:1923",
                          "eip155:42220",
                          "eip155:480",
                          "eip155:80094",
                          "eip155:57073",
                          "eip155:56",
                          "eip155:999",
                          "eip155:9745",
                          "eip155:43114",
                          "eip155:747474",
                          "eip155:59144",
                          "eip155:4326",
                          "eip155:143",
                          "eip155:42793",
                          "eip155:4663"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "allowedProtocols": {
                      "description": "Protocols to be included by protocol ID or name.",
                      "items": {
                        "minLength": 1,
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "apyInterval": {
                      "default": "7day",
                      "description": "Interval for APY data. Possible values: 1day, 7day, 30day",
                      "enum": [
                        "1day",
                        "7day",
                        "30day"
                      ],
                      "type": "string"
                    },
                    "curators": {
                      "description": "Curators to be included.",
                      "items": {
                        "minLength": 1,
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "disallowedAssets": {
                      "description": "Assets to be excluded by symbol(ticker). The parameter is ignored if \"allowedAssets\" is specified.",
                      "items": {
                        "minLength": 1,
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "disallowedNetworks": {
                      "description": "Networks to be excluded (name or CAIP). The parameter is ignored if \"allowedNetworks\" is specified.",
                      "items": {
                        "description": "Include only vaults with provided network(name or CAIP)",
                        "enum": [
                          "mainnet",
                          "optimism",
                          "arbitrum",
                          "polygon",
                          "gnosis",
                          "base",
                          "unichain",
                          "swellchain",
                          "celo",
                          "worldchain",
                          "berachain",
                          "ink",
                          "bsc",
                          "hyperliquid",
                          "plasma",
                          "avalanche",
                          "katana",
                          "linea",
                          "mega-eth",
                          "monad",
                          "etherlink",
                          "robinhood",
                          "eip155:1",
                          "eip155:10",
                          "eip155:42161",
                          "eip155:137",
                          "eip155:100",
                          "eip155:8453",
                          "eip155:130",
                          "eip155:1923",
                          "eip155:42220",
                          "eip155:480",
                          "eip155:80094",
                          "eip155:57073",
                          "eip155:56",
                          "eip155:999",
                          "eip155:9745",
                          "eip155:43114",
                          "eip155:747474",
                          "eip155:59144",
                          "eip155:4326",
                          "eip155:143",
                          "eip155:42793",
                          "eip155:4663"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "disallowedProtocols": {
                      "description": "Protocols to be excluded by protocol ID or name. The parameter is ignored if \"allowedProtocols\" is specified.",
                      "items": {
                        "minLength": 1,
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "maxApy": {
                      "description": "Maximum APY (in decimal) of the vaults to be included",
                      "type": "number"
                    },
                    "maxTvl": {
                      "description": "Maximum TVL in USD of the vaults to be included",
                      "type": "integer"
                    },
                    "minApy": {
                      "description": "Minimum APY (in decimal) of the vaults to be included",
                      "type": "number"
                    },
                    "minTvl": {
                      "default": 100000,
                      "description": "Minimum TVL in USD of the vaults to be included",
                      "minimum": 0,
                      "type": "integer"
                    },
                    "minUsdAssetValueThreshold": {
                      "default": 1,
                      "description": "Minimum USD value of the vault to be included",
                      "minimum": 0,
                      "type": "number"
                    },
                    "minVaultScore": {
                      "description": "Minimum vault score required for a vault to be included",
                      "minimum": 0,
                      "type": "number"
                    },
                    "onlyAppFeatured": {
                      "description": "Include only vaults that are featured in app.vaults.fyi",
                      "type": "boolean"
                    },
                    "onlyTransactional": {
                      "description": "Include only vaults that are supported in the transactional interface.",
                      "type": "boolean"
                    },
                    "sortBy": {
                      "description": "Field to sort by.",
                      "enum": [
                        "balanceUsd",
                        "tvl",
                        "apy1Day",
                        "apy7Day",
                        "apy30Day"
                      ],
                      "type": "string"
                    },
                    "sortOrder": {
                      "default": "asc",
                      "description": "Sort order, either asc or desc. Ascending is default.",
                      "enum": [
                        "asc",
                        "desc"
                      ],
                      "type": "string"
                    },
                    "tags": {
                      "description": "Tags to be included.",
                      "items": {
                        "minLength": 1,
                        "type": "string"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.vaults.fyi",
    "manifest_name": "api.vaults.fyi",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "type": "string"
  }
}