vaults.fyi
Identify idle (undeployed) assets in a wallet that could be earning yield. Requires header x-402-auth: true to receive x402 payment challenge.
Offering
- Provider
- vaults.fyi
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Financial Analysis
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.vaults.fyi/v2/portfolio/idle-assets/%7Baddress%7D- MIME type
- application/json
- First seen
- 2026-10-16T01:50:03.310Z
- Last seen
- Tags
- X402, DeFi, yield, vaults, Portfolio, on-chain
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact - Payment option 2
- 0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: batch-settlement
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"payTo": "0x108BCd8a07C3fdfca3Aa500784A8573123a1029F"
},
{
"scheme": "batch-settlement",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"payTo": "0x108BCd8a07C3fdfca3Aa500784A8573123a1029F"
}
]Observed health
- Status
- Reachable
- Latest latency
- 91 ms
- Average latency
- 465 ms
- HTTP status
- 400
- Last checked
- Reachability
- 100% over 13 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "http",
"method": "GET",
"pathParams": {
"type": "object",
"required": [
"userAddress"
],
"properties": {
"userAddress": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "User address to be used for best vault calculation"
}
}
},
"queryParams": {
"type": "object",
"properties": {
"sortBy": {
"enum": [
"balanceUsd"
],
"type": "string",
"description": "Field to sort the results by. Currently, only \"balanceUsd\" is supported."
},
"allowedAssets": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Assets to be included by symbol(ticker)."
},
"sortDirection": {
"enum": [
"asc",
"desc"
],
"type": "string",
"default": "asc",
"description": "Sort order, either asc or desc. Ascending is default."
},
"allowedNetworks": {
"type": "array",
"items": {
"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",
"description": "Include only vaults with provided network(name or CAIP)"
},
"default": [
"base",
"mainnet",
"arbitrum",
"optimism"
],
"description": "Networks to be included (name or CAIP)."
},
"disallowedAssets": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Assets to be excluded by symbol(ticker). The parameter is ignored if \"allowedAssets\" is specified."
},
"disallowedNetworks": {
"type": "array",
"items": {
"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",
"description": "Include only vaults with provided network(name or CAIP)"
},
"description": "Networks to be excluded (name or CAIP). The parameter is ignored if \"allowedNetworks\" is specified."
},
"minUsdAssetValueThreshold": {
"type": "number",
"default": 0.5,
"minimum": 0,
"description": "Minimum USD value of the asset to be included"
}
}
}
}Output schema
{
"type": "object",
"required": [
"data",
"errors"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"address",
"assetCaip",
"name",
"symbol",
"decimals",
"assetGroup",
"balanceNative",
"network"
],
"properties": {
"name": {
"type": "string",
"description": "Name of the asset"
},
"symbol": {
"type": "string",
"description": "Symbol of the asset"
},
"address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address of the asset"
},
"network": {
"type": "object",
"required": [
"name",
"chainId",
"networkCaip"
],
"properties": {
"name": {
"enum": [
"mainnet",
"optimism",
"arbitrum",
"polygon",
"gnosis",
"base",
"unichain",
"swellchain",
"celo",
"worldchain",
"berachain",
"ink",
"bsc",
"hyperliquid",
"plasma",
"avalanche",
"katana",
"linea",
"mega-eth",
"monad",
"etherlink",
"robinhood"
],
"type": "string",
"description": "Name of the network"
},
"chainId": {
"type": "integer",
"description": "Chain ID of the network"
},
"networkCaip": {
"type": "string",
"pattern": "^eip155:\\d+$",
"description": "CAIP-2 of the network"
}
},
"description": "Network details of the vault",
"additionalProperties": false
},
"decimals": {
"type": "integer",
"description": "Number of decimals of the asset"
},
"assetCaip": {
"type": "string",
"pattern": "^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$",
"description": "CAIP-2 of the asset"
},
"assetLogo": {
"type": "string",
"format": "uri",
"description": "URL of the asset logo"
},
"assetGroup": {
"type": "string",
"description": "Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"
},
"balanceUsd": {
"type": "string",
"description": "USD value of the asset"
},
"balanceNative": {
"type": "string",
"description": "Balance of the asset"
},
"assetPriceInUsd": {
"type": "string",
"description": "Price of the asset in USD"
}
},
"additionalProperties": false
}
},
"errors": {
"type": "object",
"required": [
"unsupportedNetworks",
"unsupportedAssets"
],
"properties": {
"unsupportedAssets": {
"type": "array",
"items": {
"type": "string"
}
},
"unsupportedNetworks": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}