{"slug":"api-vaults-fyi-v2-portfolio-positions-useraddress-5b622c","title":"Provides all vault positions for the user, with optional filters","host":"api.vaults.fyi","method":"GET","resource":"https://api.vaults.fyi/v2/portfolio/positions/:userAddress","category":"other","description":"Provides all vault positions for the user, with optional filters.","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":214,"reported_calls_30d":10,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_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_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"},"history":[{"day":"2026-10-10","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":214,"error":null}],"description_full":"Provides all vault positions for the user, with optional filters.","last_updated":"2026-10-09T23:21:13.323Z","schemes":["batch-settlement","exact"]}