{"openapi":"3.0.3","info":{"title":"Vaults.fyi Alpha API","version":"0.1.0","description":"Alpha API endpoints for features in early access. These endpoints are not included in the main API documentation and may change without notice."},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{}},"paths":{"/alpha/{network}/{vaultId}/holders":{"get":{"operationId":"listVaultHolders","summary":"List vault holders","tags":["Holders"],"description":"Retrieves current holders for a specific vault with their balances (converted to LP token amounts for rebasing vaults)","parameters":[{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"page","required":false,"description":"Page number (starting from 0)"},{"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":100},"in":"query","name":"perPage","required":false,"description":"Number of items per page"},{"schema":{"type":"string","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"]},"in":"path","name":"network","required":true,"description":"Include only vaults with provided network(name or CAIP)"},{"schema":{"type":"string"},"in":"path","name":"vaultId","required":true,"description":"Vault id of the vault for which the data will be returned"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"itemsOnPage":{"type":"integer","description":"Number of items on the current page"},"nextPage":{"type":"integer","description":"Next page number"},"data":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the holder"},"balance":{"type":"string","description":"Balance of the vault shares held by the holder"}},"required":["address","balance"],"additionalProperties":false,"description":"Array of items on the current page"}}},"required":["itemsOnPage","data"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/historical-positions/{userAddress}":{"get":{"operationId":"listHistoricalPositions","summary":"List user historical positions","tags":["Historical Positions"],"description":"Returns vaults the user held a position in (had a non-zero balance at the start of the window or deposited during the window). Both timestamps are optional.","parameters":[{"schema":{"type":"integer"},"in":"query","name":"fromTimestamp","required":false,"description":"Optional start of the window (unix seconds). Omit to start from the beginning."},{"schema":{"type":"integer"},"in":"query","name":"toTimestamp","required":false,"description":"Optional end of the window (unix seconds). Omit to use the current time."},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"userAddress","required":true,"description":"User address to fetch historical positions for"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"historicalPositions":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the vault"},"network":{"type":"object","properties":{"name":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","robinhood"],"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"}},"required":["name","chainId","networkCaip"],"additionalProperties":false,"description":"Network details of the vault"},"name":{"type":"string","description":"Name of the vault"},"protocol":{"type":"object","properties":{"name":{"type":"string","description":"Name of the protocol"},"displayName":{"type":"string","description":"Display name of the protocol"},"product":{"type":"string","description":"Product of the protocol"},"version":{"type":"string","description":"Version of the protocol"},"protocolUrl":{"type":"string","description":"URL of the protocol"},"description":{"type":"string","description":"Description of the protocol"},"protocolLogo":{"type":"string","description":"URL of the protocol logo"}},"required":["name"],"additionalProperties":false,"description":"Protocol details of the vault"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Primary asset details of the vault"},"active":{"type":"boolean","description":"Whether the user currently holds a non-zero LP token balance for the vault"}},"required":["address","network","name","protocol","asset","active"],"additionalProperties":false}}},"required":["historicalPositions"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/historical-balances/{userAddress}/{timestamp}":{"get":{"operationId":"listHistoricalBalances","summary":"List user historical balances","tags":["Historical Positions"],"description":"Returns the user vault positions and balances at a specific historical timestamp.","parameters":[{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"allowedAssets","required":false,"description":"Assets to be included by symbol(ticker)."},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"disallowedAssets","required":false,"description":"Assets to be excluded by symbol(ticker). The parameter is ignored if \"allowedAssets\" is specified."},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"allowedProtocols","required":false,"description":"Protocols to be included by name."},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"disallowedProtocols","required":false,"description":"Protocols to be excluded by name. The parameter is ignored if \"allowedProtocols\" is specified."},{"schema":{"type":"integer","default":100000},"in":"query","name":"minTvl","required":false,"description":"Minimum TVL in USD of the vaults to be included"},{"schema":{"type":"number","minimum":0},"in":"query","name":"minVaultScore","required":false,"description":"Minimum vault score required for a vault to be included"},{"schema":{"type":"boolean"},"in":"query","name":"onlyTransactional","required":false,"description":"Include only vaults that are supported in the transactional interface."},{"schema":{"type":"boolean"},"in":"query","name":"onlyAppFeatured","required":false,"description":"Include only vaults that are featured in app.vaults.fyi"},{"schema":{"type":"boolean","default":false},"in":"query","name":"allowCorrupted","required":false,"description":"Allow inclusion of corrupted vaults."},{"schema":{"type":"boolean"},"in":"query","name":"allowVaultsWithWarnings","required":false,"description":"Whether to include vaults with warnings. Defaults to true."},{"schema":{"type":"array","items":{"type":"string","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"],"description":"Include only vaults with provided network(name or CAIP)"},"default":["base","mainnet","arbitrum","optimism"]},"in":"query","name":"allowedNetworks","required":false,"description":"Networks to be included (name or CAIP)."},{"schema":{"type":"array","items":{"type":"string","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"],"description":"Include only vaults with provided network(name or CAIP)"}},"in":"query","name":"disallowedNetworks","required":false,"description":"Networks to be excluded (name or CAIP). The parameter is ignored if \"allowedNetworks\" is specified."},{"schema":{"type":"integer"},"in":"query","name":"maxTvl","required":false,"description":"Maximum TVL in USD of the vaults to be included"},{"schema":{"type":"number"},"in":"query","name":"maxApy","required":false,"description":"Maximum APY (in decimal) of the vaults to be included"},{"schema":{"type":"number"},"in":"query","name":"minApy","required":false,"description":"Minimum APY (in decimal) of the vaults to be included"},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"tags","required":false,"description":"Tags to be included."},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"curators","required":false,"description":"Curators to be included."},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"in":"query","name":"sortOrder","required":false,"description":"Sort order, either asc or desc. Ascending is default."},{"schema":{"type":"string","enum":["balanceUsd","tvl","apy1Day","apy7Day","apy30Day"]},"in":"query","name":"sortBy","required":false,"description":"Field to sort by."},{"schema":{"type":"string","enum":["1day","7day","30day"],"default":"7day"},"in":"query","name":"apyInterval","required":false,"description":"Interval for APY data. Possible values: 1day, 7day, 30day"},{"schema":{"type":"number","minimum":0,"default":1},"in":"query","name":"minUsdAssetValueThreshold","required":false,"description":"Minimum USD value of the vault to be included"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"userAddress","required":true,"description":"User address to fetch historical balances for"},{"schema":{"type":"integer"},"in":"path","name":"timestamp","required":true,"description":"Unix timestamp (seconds) to fetch balances at"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string","description":"Stable vault identity for API lookups and links"},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the vault"},"network":{"type":"object","properties":{"name":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","robinhood"],"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"}},"required":["name","chainId","networkCaip"],"additionalProperties":false,"description":"Network details of the vault"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"},"balanceNative":{"type":"string","description":"Balance of the asset denominated in asset precision"},"balanceUsd":{"type":"string","description":"Balance of the asset denominated in usd. Omitted when no price is available."},"unclaimedNative":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in asset precision"},"unclaimedUsd":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in usd"},"positionValueInAsset":{"type":"string","description":"Position value in asset denominated in asset precision"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup","balanceNative"],"additionalProperties":false,"description":"Asset details of the vault"},"name":{"type":"string","description":"Name of the vault"},"protocol":{"type":"object","properties":{"name":{"type":"string","description":"Name of the protocol"},"displayName":{"type":"string","description":"Display name of the protocol"},"product":{"type":"string","description":"Product of the protocol"},"version":{"type":"string","description":"Version of the protocol"},"protocolUrl":{"type":"string","description":"URL of the protocol"},"description":{"type":"string","description":"Description of the protocol"},"protocolLogo":{"type":"string","description":"URL of the protocol logo"}},"required":["name"],"additionalProperties":false,"description":"Protocol details of the vault"},"additionalAssets":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"},"balanceNative":{"type":"string","description":"Balance of the asset denominated in asset precision"},"balanceUsd":{"type":"string","description":"Balance of the asset denominated in usd. Omitted when no price is available."},"unclaimedNative":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in asset precision"},"unclaimedUsd":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in usd"},"positionValueInAsset":{"type":"string","description":"Position value in asset denominated in asset precision"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup","balanceNative"],"additionalProperties":false},"description":"Additional assets of the vault"},"lpToken":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the LP token"},"tokenCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the LP token"},"name":{"type":"string","description":"Name of the LP token"},"symbol":{"type":"string","description":"Symbol of the LP token"},"decimals":{"type":"integer","description":"Number of decimals of the LP token"},"balanceNative":{"type":"string","description":"Balance of the asset denominated in asset precision"},"balanceUsd":{"type":"string","description":"Balance of the asset denominated in usd. Omitted when no price is available."},"unclaimedNative":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in asset precision"},"unclaimedUsd":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in usd"},"positionValueInAsset":{"type":"string","description":"Position value in asset denominated in asset precision"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"}},"required":["address","tokenCaip","name","symbol","decimals","balanceNative"],"additionalProperties":false,"description":"LP token details of the vault"},"childrenVaults":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string","description":"Vault id of the child vault"},"address":{"type":"string","description":"Address of the child vault"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"},"balanceNative":{"type":"string","description":"Balance of the asset denominated in asset precision"},"balanceUsd":{"type":"string","description":"Balance of the asset denominated in usd. Omitted when no price is available."},"unclaimedNative":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in asset precision"},"unclaimedUsd":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in usd"},"positionValueInAsset":{"type":"string","description":"Position value in asset denominated in asset precision"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup","balanceNative"],"additionalProperties":false,"description":"Asset details of the child vault"},"lpToken":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the LP token"},"tokenCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the LP token"},"name":{"type":"string","description":"Name of the LP token"},"symbol":{"type":"string","description":"Symbol of the LP token"},"decimals":{"type":"integer","description":"Number of decimals of the LP token"},"balanceNative":{"type":"string","description":"Balance of the asset denominated in asset precision"},"balanceUsd":{"type":"string","description":"Balance of the asset denominated in usd. Omitted when no price is available."},"unclaimedNative":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in asset precision"},"unclaimedUsd":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in usd"},"positionValueInAsset":{"type":"string","description":"Position value in asset denominated in asset precision"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"}},"required":["address","tokenCaip","name","symbol","decimals","balanceNative"],"additionalProperties":false,"description":"LP token details of the child vault"},"additionalAssets":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"},"balanceNative":{"type":"string","description":"Balance of the asset denominated in asset precision"},"balanceUsd":{"type":"string","description":"Balance of the asset denominated in usd. Omitted when no price is available."},"unclaimedNative":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in asset precision"},"unclaimedUsd":{"type":"string","description":"Unclaimed balance of the asset in the position denominated in usd"},"positionValueInAsset":{"type":"string","description":"Position value in asset denominated in asset precision"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup","balanceNative"],"additionalProperties":false},"description":"Additional assets of the child vault"}},"required":["vaultId","address","asset"],"additionalProperties":false},"description":"List of child vaults"}},"required":["vaultId","address","network","asset","name","protocol"],"additionalProperties":false},"description":"List of historical balance items"},"errors":{"type":"object","properties":{"unsupportedNetworks":{"type":"array","items":{"type":"string"}},"unsupportedAssets":{"type":"array","items":{"type":"string"}},"unsupportedProtocols":{"type":"array","items":{"type":"string"}}},"required":["unsupportedNetworks","unsupportedAssets","unsupportedProtocols"],"additionalProperties":false}},"required":["data","errors"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/historical/{network}/{vaultId}/daily-flows":{"get":{"operationId":"getHistoricalDailyFlows","summary":"Get historical daily vault flows","tags":["Historical"],"description":"Retrieves daily UTC vault deposit and redemption totals for a specific vault over an exclusive date range.","parameters":[{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"page","required":false,"description":"Page number (starting from 0)"},{"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":366,"default":100},"in":"query","name":"perPage","required":false,"description":"Number of items per page"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"fromDate","required":true,"description":"UTC start date, inclusive, in YYYY-MM-DD format"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"toDate","required":true,"description":"UTC end date, exclusive, in YYYY-MM-DD format"},{"schema":{"type":"string","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"]},"in":"path","name":"network","required":true,"description":"Include only vaults with provided network(name or CAIP)"},{"schema":{"type":"string"},"in":"path","name":"vaultId","required":true,"description":"Vault id of the vault for which the data will be returned"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Daily vault deposit and redemption flows, paginated by UTC date","content":{"application/json":{"schema":{"type":"object","properties":{"itemsOnPage":{"type":"integer","description":"Number of items on the current page"},"nextPage":{"type":"integer","description":"Next page number"},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"UTC calendar date for the daily flow bucket in YYYY-MM-DD format"},"totalDeposits":{"type":"string","description":"Approximate total vault deposits for the day in native token units"},"totalRedemptions":{"type":"string","description":"Approximate total vault redemptions for the day in native token units"},"depositCount":{"type":"integer","description":"Number of deposit event rows for the day"},"redemptionCount":{"type":"integer","description":"Number of withdrawal event rows for the day"},"uniqueDepositors":{"type":"integer","description":"Number of unique depositors for the day"},"uniqueRedeemers":{"type":"integer","description":"Number of unique redeemers for the day"}},"required":["date","totalDeposits","totalRedemptions","depositCount","redemptionCount","uniqueDepositors","uniqueRedeemers"],"additionalProperties":false,"description":"Array of items on the current page"}}},"required":["itemsOnPage","data"],"additionalProperties":false,"description":"Daily vault deposit and redemption flows, paginated by UTC date"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/transactions/intent/getQuote":{"post":{"operationId":"createTransactionIntentQuote","summary":"Create transaction intent quote","tags":["Cross Chain"],"description":"Get transaction intent quote for cross-chain or same-chain position changes. Returns EIP-712 payload for signing and fee breakdown.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"User wallet address"},"inputPosition":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Token contract address"},"network":{"type":"string","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"],"description":"Network name or CAIP identifier"},"amount":{"type":"string","description":"Amount in base units"}},"required":["address","network","amount"],"additionalProperties":false,"description":"Input position details"},"outputPosition":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Token contract address"},"network":{"type":"string","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"],"description":"Network name or CAIP identifier"}},"required":["address","network"],"additionalProperties":false,"description":"Output position details"},"feeToken":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Fee token contract address"},"network":{"type":"string","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"],"description":"Network name or CAIP identifier"}},"required":["address","network"],"additionalProperties":false,"description":"Fee token details"},"provider":{"type":"string","enum":["biconomy","rhinestone"],"description":"Provider name"}},"required":["userAddress","inputPosition","outputPosition","feeToken","provider"],"additionalProperties":false}}},"required":true},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"payloadToSign":{"type":"object","properties":{"domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"chainId":{"type":"number"},"verifyingContract":{"type":"string"}},"required":["name","chainId","verifyingContract"],"additionalProperties":false,"description":"EIP-712 domain data"},"types":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"],"additionalProperties":false}},"description":"EIP-712 type definitions"},"message":{"type":"object","additionalProperties":{},"description":"Message data to be signed"},"primaryType":{"type":"string","description":"Primary type name (e.g., \"Permit\")"}},"required":["domain","types","message","primaryType"],"additionalProperties":false,"description":"EIP-712 payload for user to sign"},"setupTransactions":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"chainId":{"type":"integer","exclusiveMinimum":true,"minimum":0},"data":{"type":"string"},"value":{"type":"string"}},"required":["to","chainId"],"additionalProperties":false}},"description":"Transactions that need to be executed before the intent execution. Grouped by chain ID."},"fees":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bridge","gas","orchestrator","protocol"]},"token":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Token contract address"},"network":{"type":"string","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"],"description":"Token network name or CAIP identifier"},"decimals":{"type":"number","description":"Token decimals"}},"required":["address","network","decimals"],"additionalProperties":false},"amount":{"type":"string","description":"Fee amount in base units"}},"required":["type","token","amount"],"additionalProperties":false},"description":"Breakdown of all fees"},"totalCost":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Asset contract address"},"network":{"type":"string","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"],"description":"Asset network name or CAIP identifier"},"decimals":{"type":"number","description":"Asset decimals"},"amount":{"type":"string","description":"Amount in base units"}},"required":["address","network","decimals","amount"],"additionalProperties":false},"description":"Total cost including all fees"},"receivedPosition":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Asset contract address"},"network":{"type":"string","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"],"description":"Asset network name or CAIP identifier"},"decimals":{"type":"number","description":"Asset decimals"},"amount":{"type":"string","description":"Amount in base units"}},"required":["address","network","decimals","amount"],"additionalProperties":false,"description":"Position that will be received"},"receivedAssetValue":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Asset contract address"},"network":{"type":"string","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"],"description":"Asset network name or CAIP identifier"},"decimals":{"type":"number","description":"Asset decimals"},"amount":{"type":"string","description":"Amount in base units"}},"required":["address","network","decimals","amount"],"additionalProperties":false,"description":"Underlying asset value of the received position"},"expirationTimestamp":{"type":"number","description":"Timestamp when the quote expires"},"originalQuote":{"description":"Original quote data from the intent service"}},"required":["payloadToSign","fees","totalCost","receivedPosition","receivedAssetValue"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/transactions/intent/execute":{"post":{"operationId":"executeTransactionIntent","summary":"Execute transaction intent","tags":["Cross Chain"],"description":"Execute a transaction intent with a signed payload. Returns the supertransaction hash for tracking.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"payloadSignature":{"type":"string","pattern":"^0x[a-fA-F0-9]*$","description":"Signed EIP-712 payload signature"},"originalQuote":{"description":"Original quote data from getQuote endpoint"},"provider":{"type":"string","enum":["biconomy","rhinestone"]}},"required":["payloadSignature","provider"],"additionalProperties":false}}},"required":true},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"crosschainTransactionId":{"type":"string","description":"Crosschain transaction ID. Format depends on the provider."}},"required":["crosschainTransactionId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/transactions/intent/status":{"get":{"operationId":"getTransactionIntentStatus","summary":"Get transaction intent status","tags":["Cross Chain"],"description":"Get the status of a crosschain transaction intent.","parameters":[{"schema":{"type":"string"},"in":"query","name":"crosschainTransactionId","required":true,"description":"Crosschain transaction ID returned from the execute endpoint."},{"schema":{"type":"string","enum":["rhinestone","biconomy"]},"in":"query","name":"provider","required":true,"description":"The intent provider used for the transaction."}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["pending","success","failed"],"description":"Current status of the crosschain transaction."}},"required":["status"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/transactions/cctp/context/{userAddress}/{srcNetwork}/{dstNetwork}/{assetAddress}":{"get":{"operationId":"getCctpTransactionContext","summary":"Get CCTP transaction context","tags":["CCTP Bridge"],"description":"Retrieves context for a CCTP cross-chain bridge operation, including asset balance, allowance, and fees","parameters":[{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"userAddress","required":true,"description":"User wallet address"},{"schema":{"type":"string","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"]},"in":"path","name":"srcNetwork","required":true,"description":"Source chain (network name or CAIP identifier)"},{"schema":{"type":"string","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"]},"in":"path","name":"dstNetwork","required":true,"description":"Destination chain (network name or CAIP identifier)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"assetAddress","required":true,"description":"Asset address to bridge (e.g., USDC)"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"srcNetwork":{"type":"object","properties":{"name":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","robinhood"]},"chainId":{"type":"integer"},"networkCaip":{"type":"string","pattern":"^eip155:\\d+$"}},"required":["name","chainId","networkCaip"],"additionalProperties":false,"description":"Source network"},"dstNetwork":{"type":"object","properties":{"name":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","robinhood"]},"chainId":{"type":"integer"},"networkCaip":{"type":"string","pattern":"^eip155:\\d+$"}},"required":["name","chainId","networkCaip"],"additionalProperties":false,"description":"Destination network"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"symbol":{"type":"string"},"decimals":{"type":"number"},"name":{"type":"string"},"balanceNative":{"type":"string","description":"User balance in base units"},"allowance":{"type":"string","description":"Current allowance for TokenMessengerV2"}},"required":["address","symbol","decimals","name","balanceNative","allowance"],"additionalProperties":false},"fees":{"type":"object","properties":{"standardTransferFeeBps":{"type":"number","description":"Service fee for standard transfer in basis points"},"fastTransferFeeBps":{"type":"number","description":"Service fee for fast transfer in basis points"},"forwardingFeeNative":{"type":"string","description":"Fixed service fee per destination in base asset units"}},"required":["standardTransferFeeBps","fastTransferFeeBps","forwardingFeeNative"],"additionalProperties":false,"description":"Fees for forwarding mode (fetched from Iris API)"},"currentBridgeStep":{"type":"string","enum":["bridge","claim"],"description":"Current step in bridge flow"},"bridgeSteps":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["bridge","claim"]},"actions":{"type":"array","items":{"type":"string"},"description":"Available actions for this step"},"actionsUrl":{"type":"string","description":"URL to get transaction data for this step"}},"required":["name","actions","actionsUrl"],"additionalProperties":false},"description":"Steps for bridging: bridge, then claim"},"moneyInTransit":{"type":"array","items":{"type":"object","properties":{"burnToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"amountNative":{"type":"string","description":"Burn amount in base units"},"mintRecipient":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"destinationDomain":{"type":"number"},"status":{"type":"string","enum":["pending","attested","complete","expired"]},"message":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"attestation":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"depositor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},"required":["burnToken","amountNative","mintRecipient","destinationDomain","status","depositor"],"additionalProperties":false},"description":"Recent CCTP transfers that are still in transit"}},"required":["srcNetwork","dstNetwork","asset","fees","currentBridgeStep","bridgeSteps","moneyInTransit"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/transactions/cctp/money-in-transit/{userAddress}":{"get":{"operationId":"listCctpMoneyInTransit","summary":"List CCTP money in transit","tags":["CCTP Bridge"],"description":"Returns CCTP money-in-transit transfers for all supported source/destination chain pairs","parameters":[{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"userAddress","required":true,"description":"User wallet address"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"routes":{"type":"array","items":{"type":"object","properties":{"srcNetwork":{"type":"object","properties":{"name":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","robinhood"]},"chainId":{"type":"integer"},"networkCaip":{"type":"string","pattern":"^eip155:\\d+$"}},"required":["name","chainId","networkCaip"],"additionalProperties":false,"description":"Source network"},"dstNetwork":{"type":"object","properties":{"name":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","robinhood"]},"chainId":{"type":"integer"},"networkCaip":{"type":"string","pattern":"^eip155:\\d+$"}},"required":["name","chainId","networkCaip"],"additionalProperties":false,"description":"Destination network"},"moneyInTransit":{"type":"array","items":{"type":"object","properties":{"burnToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"amountNative":{"type":"string","description":"Burn amount in base units"},"mintRecipient":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"destinationDomain":{"type":"number"},"status":{"type":"string","enum":["pending","attested","complete","expired"]},"message":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"attestation":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"}},"required":["burnToken","amountNative","mintRecipient","destinationDomain","status"],"additionalProperties":false}}},"required":["srcNetwork","dstNetwork","moneyInTransit"],"additionalProperties":false}}},"required":["routes"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/transactions/cctp/transactions/{action}/{userAddress}/{srcNetwork}/{dstNetwork}":{"get":{"operationId":"createCctpTransaction","summary":"Create CCTP transaction","tags":["CCTP Bridge"],"description":"Retrieves executable transaction payloads for CCTP bridge actions (bridge or claim)","parameters":[{"schema":{"type":"string"},"in":"query","name":"amount","required":false,"description":"Amount to bridge in base units"},{"schema":{"type":"boolean","default":"false"},"in":"query","name":"useForwarding","required":false,"description":"Use relay service for auto-claim"},{"schema":{"type":"string","enum":["standard","fast"],"default":"standard"},"in":"query","name":"transferType","required":false,"description":"Type of transfer for fee calculation (only applicable for bridge action)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"query","name":"recipientAddress","required":false,"description":"Recipient on destination (defaults to userAddress)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"query","name":"assetAddress","required":false,"description":"Asset to bridge (defaults to USDC)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"in":"query","name":"message","required":false,"description":"Message from status endpoint (required for claim)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"in":"query","name":"attestation","required":false,"description":"Attestation from status endpoint (required for claim)"},{"schema":{"type":"string","enum":["bridge","claim"]},"in":"path","name":"action","required":true,"description":"Action to perform: bridge or claim"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"userAddress","required":true,"description":"User wallet address"},{"schema":{"type":"string","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"]},"in":"path","name":"srcNetwork","required":true,"description":"Source network"},{"schema":{"type":"string","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"]},"in":"path","name":"dstNetwork","required":true,"description":"Destination network"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"currentActionIndex":{"type":"number"},"actions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the action"},"tx":{"type":"object","properties":{"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the transaction recipient"},"chainId":{"type":"integer","exclusiveMinimum":true,"minimum":0,"description":"Chain ID of the transaction"},"data":{"type":"string","description":"Data to be sent with the transaction"},"value":{"type":"string","description":"Value to be sent with the transaction"}},"required":["to","chainId"],"additionalProperties":false},"simulation":{"type":"object","properties":{"url":{"type":"string","description":"URL to simulated transaction"},"status":{"type":"string","enum":["success","failure","internal server error"],"description":"Status of the simulation"},"tokensReceived":{"type":"object","additionalProperties":{"type":"string"},"description":"Tokens received from the transaction"},"tokensSpent":{"type":"object","additionalProperties":{"type":"string"},"description":"Tokens spent in the transaction"}},"required":["url","status"],"additionalProperties":false}},"required":["name","tx"],"additionalProperties":false}}},"required":["currentActionIndex","actions"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/transactions/cctp/status":{"get":{"operationId":"getCctpTransactionStatus","summary":"Get CCTP transaction status","tags":["CCTP Bridge"],"description":"Checks the status of a CCTP bridge transaction via Circle Iris API","parameters":[{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"in":"query","name":"burnTxHash","required":true,"description":"Transaction hash of the burn transaction on source chain"},{"schema":{"type":"string","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"]},"in":"query","name":"srcNetwork","required":true,"description":"Source chain where burn occurred"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["pending","pending_confirmations","attested","complete","failed"],"description":"Current status of the bridge transaction"},"burnTxHash":{"type":"string","pattern":"^0x[a-fA-F0-9]*$","description":"Original burn transaction hash"},"message":{"type":"string","pattern":"^0x[a-fA-F0-9]*$","description":"Message bytes for claim (available when attested)"},"attestation":{"type":"string","pattern":"^0x[a-fA-F0-9]*$","description":"Attestation bytes for claim (available when attested)"},"forwardTxHash":{"type":"string","pattern":"^0x[a-fA-F0-9]*$","description":"Relay transaction hash (for forwarding mode)"}},"required":["status","burnTxHash"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/advanced-analytics":{"post":{"operationId":"listAdvancedAnalytics","summary":"List advanced vault analytics","tags":["Advanced Analytics"],"description":"Returns a paginated list of vaults with advanced analytics. Filtering/pagination is passed via querystring (mirrors the v2 detailed-vaults list endpoint). Use the POST body `select` to opt into per-item analytics sections — max drawdown, withdrawal pause ratio and/or the full v2 `detailedVault` payload. Pricing scales per returned item: each item costs 1 base credit + 2 if `maxDrawdown` is included + 3 if `detailedVault` is included + 2 if `withdrawalPauseRatio` is included.\n\n**Note:** analytics values are currently mocked and will be replaced with real data as the underlying pipelines are exposed.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"select":{"type":"object","properties":{"maxDrawdown":{"type":"boolean","enum":[true],"description":"Include max-drawdown metrics for vault price per share"},"detailedVault":{"type":"boolean","enum":[true],"description":"Embed the full v2 detailedVault payload"},"withdrawalPauseRatio":{"type":"boolean","enum":[true],"description":"Include ratio of time the vault withdrawals were paused over the last 2 years. Returns null when the protocol does not expose a withdrawal-pause event source or the underlying tracked event has not yet been backfilled."},"composition":{"type":"boolean","enum":[true],"description":"Include composition for the vault."}},"additionalProperties":false,"description":"Choose which analytics sections to include in the response. Pricing scales with the selection."}},"additionalProperties":false,"description":"Request body for the advanced-analytics list endpoint. Use `select` to opt into per-item analytics sections."}}},"description":"Request body for the advanced-analytics list endpoint. Use `select` to opt into per-item analytics sections."},"parameters":[{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"page","required":false,"description":"Page number (starting from 0)"},{"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":5000,"default":50},"in":"query","name":"perPage","required":false,"description":"Number of items per page"},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"allowedAssets","required":false,"description":"Assets to be included by symbol(ticker)."},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"disallowedAssets","required":false,"description":"Assets to be excluded by symbol(ticker). The parameter is ignored if \"allowedAssets\" is specified."},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"allowedProtocols","required":false,"description":"Protocols to be included by name."},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"disallowedProtocols","required":false,"description":"Protocols to be excluded by name. The parameter is ignored if \"allowedProtocols\" is specified."},{"schema":{"type":"integer","default":100000},"in":"query","name":"minTvl","required":false,"description":"Minimum TVL in USD of the vaults to be included"},{"schema":{"type":"number","minimum":0},"in":"query","name":"minVaultScore","required":false,"description":"Minimum vault score required for a vault to be included"},{"schema":{"type":"boolean"},"in":"query","name":"onlyTransactional","required":false,"description":"Include only vaults that are supported in the transactional interface."},{"schema":{"type":"boolean"},"in":"query","name":"onlyAppFeatured","required":false,"description":"Include only vaults that are featured in app.vaults.fyi"},{"schema":{"type":"boolean","default":false},"in":"query","name":"allowCorrupted","required":false,"description":"Allow inclusion of corrupted vaults."},{"schema":{"type":"boolean"},"in":"query","name":"allowVaultsWithWarnings","required":false,"description":"Whether to include vaults with warnings. Defaults to true."},{"schema":{"type":"array","items":{"type":"string","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"],"description":"Include only vaults with provided network(name or CAIP)"},"default":["base","mainnet","arbitrum","optimism"]},"in":"query","name":"allowedNetworks","required":false,"description":"Networks to be included (name or CAIP)."},{"schema":{"type":"array","items":{"type":"string","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"],"description":"Include only vaults with provided network(name or CAIP)"}},"in":"query","name":"disallowedNetworks","required":false,"description":"Networks to be excluded (name or CAIP). The parameter is ignored if \"allowedNetworks\" is specified."},{"schema":{"type":"integer"},"in":"query","name":"maxTvl","required":false,"description":"Maximum TVL in USD of the vaults to be included"},{"schema":{"type":"number"},"in":"query","name":"maxApy","required":false,"description":"Maximum APY (in decimal) of the vaults to be included"},{"schema":{"type":"number"},"in":"query","name":"minApy","required":false,"description":"Minimum APY (in decimal) of the vaults to be included"},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"tags","required":false,"description":"Tags to be included."},{"schema":{"type":"array","items":{"type":"string","minLength":1}},"in":"query","name":"curators","required":false,"description":"Curators to be included."},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"in":"query","name":"sortOrder","required":false,"description":"Sort order, either asc or desc. Ascending is default."},{"schema":{"type":"string","enum":["tvl","apy1day","apy7day","apy30day"]},"in":"query","name":"sortBy","required":false,"description":"Field to sort by"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"itemsOnPage":{"type":"integer","description":"Number of items on the current page"},"nextPage":{"type":"integer","description":"Next page number"},"data":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string"},"network":{"type":"string"},"maxDrawdown":{"type":"object","properties":{"mdd30days":{"type":"number","description":"Largest observed peak-to-trough drop in the vault price per share over the last 30 days, reported as a decimal (e.g. 0.12 = 12%)."},"mdd90days":{"type":"number","description":"Largest observed peak-to-trough drop in the vault price per share over the last 90 days, reported as a decimal (e.g. 0.12 = 12%)."},"mdd365days":{"type":"number","description":"Largest observed peak-to-trough drop in the vault price per share over the last 365 days, reported as a decimal (e.g. 0.12 = 12%)."}},"required":["mdd30days","mdd90days","mdd365days"],"additionalProperties":false,"description":"Max drawdown metrics for vault price per share"},"detailedVault":{"type":"object","properties":{"vaultId":{"type":"string","description":"Stable vault identity for API lookups and links"},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the vault"},"name":{"type":"string","description":"Name of the vault"},"network":{"type":"object","properties":{"name":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","robinhood"],"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"}},"required":["name","chainId","networkCaip"],"additionalProperties":false,"description":"Network details of the vault"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Asset details of the vault"},"isTransactional":{"type":"boolean","description":"Indicates if the vault supports transactional endpoints"},"isAppFeatured":{"type":"boolean","description":"Indicates if the vault is featured in app.vaults.fyi"},"protocol":{"type":"object","properties":{"name":{"type":"string","description":"Name of the protocol"},"displayName":{"type":"string","description":"Display name of the protocol"},"product":{"type":"string","description":"Product of the protocol"},"version":{"type":"string","description":"Version of the protocol"},"protocolUrl":{"type":"string","description":"URL of the protocol"},"description":{"type":"string","description":"Description of the protocol"},"protocolLogo":{"type":"string","description":"URL of the protocol logo"}},"required":["name"],"additionalProperties":false,"description":"Protocol details of the vault"},"lendUrl":{"type":"string","description":"URL to lend the asset"},"description":{"type":"string","description":"Description of the vault"},"protocolVaultUrl":{"type":"string","description":"URL to the protocol vault"},"tags":{"type":"array","items":{"type":"string","minLength":1},"description":"Tags of the vault"},"holdersData":{"type":"object","properties":{"totalCount":{"type":"number","description":"Number of holders of the vault"},"totalBalance":{"type":"string","description":"Total balance of the vault holders"},"topHolders":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the holder"},"lpTokenBalance":{"type":"string","description":"Balance of the LP token of the holder"}},"required":["address","lpTokenBalance"],"additionalProperties":false},"description":"Top holders of the vault"}},"additionalProperties":false},"apy":{"type":"object","properties":{"1day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1day APY details"},"7day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"7day APY details"},"30day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"30day APY details"},"1hour":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1hour APY details"}},"required":["1day","7day","30day","1hour"],"additionalProperties":false,"description":"APY details of the vault"},"tvl":{"type":"object","properties":{"usd":{"type":"string","description":"TVL in USD"},"native":{"type":"string","description":"Native TVL"}},"required":["usd","native"],"additionalProperties":false,"description":"TVL details of the vault"},"lastUpdateTimestamp":{"type":"integer","description":"Timestamp of the last vault data update"},"creationData":{"type":"object","properties":{"deploymentTimestamp":{"type":"integer","description":"Timestamp of the vault contract deployment block"}},"required":["deploymentTimestamp"],"additionalProperties":false,"description":"Vault contract creation data"},"rewards":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Asset details of the reward"},"apy":{"type":"object","properties":{"1hour":{"type":"number","description":"1hour APY of the reward asset"},"1day":{"type":"number","description":"1day APY of the reward asset"},"7day":{"type":"number","description":"7day APY of the reward asset"},"30day":{"type":"number","description":"30day APY of the reward asset"}},"required":["1hour","1day","7day","30day"],"additionalProperties":false}},"required":["asset","apy"],"additionalProperties":false},"description":"List of rewards for the vault"},"score":{"type":"object","properties":{"vaultScore":{"type":"number","description":"Score of the vault"},"vaultTvlScore":{"type":"number","description":"TVL score of the vault"},"protocolTvlScore":{"type":"number","description":"TVL score of the protocol"},"holderScore":{"type":"number","description":"Holder score of the vault"},"networkScore":{"type":"number","description":"Network score of the vault"},"assetScore":{"type":"number","description":"Asset score of the vault"},"totalScorePenalty":{"type":"number","description":"Penalty applied to the vault score"},"penaltyComponents":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"content":{"type":"string","description":"Content of the flag"},"severity":{"type":"string","enum":["info","warning","critical"],"description":"Severity level of the flag"},"endDate":{"type":"number","description":"Unix timestamp (seconds) when this flag expires"},"resolution":{"type":"string","description":"Resolution details if the flag has been resolved"},"type":{"type":"string","enum":["flag"],"description":"Type of the penalty component"},"value":{"type":"number","description":"Value of the penalty component, e.g., flag penalty or score factor penalty"}},"required":["content","severity","endDate","type","value"],"additionalProperties":false,"description":"Penalty component derived from a flag"},{"type":"object","properties":{"type":{"type":"string","description":"Type of the penalty component, e.g., score factor penalty"},"value":{"type":"number","description":"Value of the score factor penalty, e.g., 0.1 for a 10% penalty"}},"required":["type","value"],"additionalProperties":false,"description":"Penalty component derived from a score factor"}]},"description":"List of penalty components applied to the vault score"}},"required":["vaultScore","vaultTvlScore","protocolTvlScore","holderScore","networkScore","assetScore","totalScorePenalty","penaltyComponents"],"additionalProperties":false,"description":"Score details of the vault"},"additionalIncentives":{"type":"string","description":"Additional incentives of the vault"},"curator":{"type":"object","properties":{"name":{"type":"string","description":"Name of the curator"},"description":{"type":"string","description":"Description of the curator"},"websiteUrl":{"type":"string","description":"Website URL of the curator"}},"required":["name"],"additionalProperties":false,"description":"Curator of the vault"},"lpToken":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the LP token"},"tokenCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the LP token"},"name":{"type":"string","description":"Name of the LP token"},"symbol":{"type":"string","description":"Symbol of the LP token"},"decimals":{"type":"integer","description":"Number of decimals of the LP token"}},"required":["address","tokenCaip","name","symbol","decimals"],"additionalProperties":false,"description":"LP token details of the vault"},"remainingCapacity":{"type":"string","description":"Remaining capacity of the vault"},"maxCapacity":{"type":"string","description":"Maximum capacity limit of the vault"},"isCorrupted":{"type":"boolean","description":"Indicates if the vault is corrupted"},"userEventsIndexed":{"type":"boolean","description":"Indicates if user events related to the vault are indexed and available in the API"},"childrenVaults":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string","description":"Vault id of the child vault"},"address":{"type":"string","description":"Address of the child vault"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Asset details of the child vault"},"lpToken":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the LP token"},"tokenCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the LP token"},"name":{"type":"string","description":"Name of the LP token"},"symbol":{"type":"string","description":"Symbol of the LP token"},"decimals":{"type":"integer","description":"Number of decimals of the LP token"}},"required":["address","tokenCaip","name","symbol","decimals"],"additionalProperties":false,"description":"LP token details of the child vault"},"additionalAssets":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false},"description":"Additional assets of the child vault"}},"required":["vaultId","address","asset"],"additionalProperties":false},"description":"List of child vaults"},"additionalAssets":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false},"description":"Additional assets of the vault"},"transactionalProperties":{"type":"object","properties":{"depositStepsType":{"type":"string","enum":["instant","complex"],"description":"Type of transaction steps, either \"instant\" or \"complex\""},"redeemStepsType":{"type":"string","enum":["instant","complex"],"description":"Type of transaction steps, either \"instant\" or \"complex\""},"rewardsSupported":{"type":"boolean","description":"Indicates if the vault supports rewards transaction flows"}},"required":["depositStepsType","redeemStepsType","rewardsSupported"],"additionalProperties":false,"description":"Transactional properties of the vault"},"fees":{"type":"object","properties":{"performanceFee":{"type":"number","description":"Performance fee as decimal"},"managementFee":{"type":"number","description":"Management fee as decimal"},"withdrawalFee":{"type":"number","description":"Withdrawal fee as decimal"},"depositFee":{"type":"number","description":"Deposit fee as decimal"}},"additionalProperties":false,"description":"Fee structure of the vault"},"warnings":{"type":"array","items":{"type":"string"},"description":"List of warnings related to the vault"},"flags":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"Content of the flag"},"severity":{"type":"string","enum":["info","warning","critical"],"description":"Severity level of the flag"},"endDate":{"type":"number","description":"Unix timestamp (seconds) when this flag expires"},"resolution":{"type":"string","description":"Resolution details if the flag has been resolved"}},"required":["content","severity","endDate"],"additionalProperties":false},"description":"List of flags with severity and expiry information"},"apyComposite":{"type":"object","properties":{"totalApy":{"type":"object","properties":{"1day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1day APY details"},"7day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"7day APY details"},"30day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"30day APY details"},"1hour":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1hour APY details"}},"required":["1day","7day","30day","1hour"],"additionalProperties":false,"description":"Compounded APY details combining the vault and its underlying vault"},"intrinsicApy":{"type":"object","properties":{"1day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1day APY details"},"7day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"7day APY details"},"30day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"30day APY details"},"1hour":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1hour APY details"}},"required":["1day","7day","30day","1hour"],"additionalProperties":false,"description":"APY details of the underlying vault before compounding"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Asset details of the underlying vault"},"vault":{"type":"object","properties":{"vaultId":{"type":"string","description":"Vault id of the underlying vault"},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the underlying vault"}},"required":["vaultId","address"],"additionalProperties":false}},"required":["totalApy","intrinsicApy","asset","vault"],"additionalProperties":false,"description":"Composite APY data when vault asset is another vault LP token. When present, totalApy compounds the current vault with the underlying vault and intrinsicApy shows the underlying vault's own APY"}},"required":["vaultId","address","name","network","asset","isTransactional","isAppFeatured","protocol","tags","holdersData","apy","tvl","lastUpdateTimestamp","creationData","rewards","isCorrupted","userEventsIndexed","warnings","flags"],"additionalProperties":false},"withdrawalPauseRatio":{"type":"number","nullable":true,"description":"Ratio (0-1) of time the vault withdrawals were paused over the last 2 years. Null when the protocol has no withdrawal-pause event source or the tracked event has not yet been backfilled."},"composition":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifier for the investment"},"supplyAssets":{"type":"string","description":"Amount of underlying assets supplied to the investment by the vault"},"allocation":{"type":"number","description":"Percentage allocation of the whole vault in investment, as a decimal (e.g. 0.12 = 12%)"},"name":{"type":"string","description":"Name of the investment"},"type":{"type":"string","enum":["market","idle"],"description":"Whether the composition item is a Morpho market or idle vault assets"}},"required":["id","supplyAssets","allocation","name","type"],"additionalProperties":false},"nullable":true,"description":"List of investments the vault is allocated to, with allocation percentages."}},"required":["vaultId","network"],"additionalProperties":false,"description":"Array of items on the current page"}},"errors":{"type":"object","properties":{"unsupportedNetworks":{"type":"array","items":{"type":"string"}},"unsupportedAssets":{"type":"array","items":{"type":"string"}},"unsupportedProtocols":{"type":"array","items":{"type":"string"}}},"required":["unsupportedNetworks","unsupportedAssets","unsupportedProtocols"],"additionalProperties":false}},"required":["itemsOnPage","data","errors"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}},"/alpha/advanced-analytics/{network}/{vaultId}":{"post":{"operationId":"getAdvancedAnalytics","summary":"Get advanced vault analytics","tags":["Advanced Analytics"],"description":"Returns advanced analytics for a single vault. Use the POST body `select` to opt into analytics sections — max drawdown, withdrawal pause ratio, composition and/or the full v2 `detailedVault` payload.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"select":{"type":"object","properties":{"maxDrawdown":{"type":"boolean","enum":[true],"description":"Include max-drawdown metrics for vault price per share"},"detailedVault":{"type":"boolean","enum":[true],"description":"Embed the full v2 detailedVault payload"},"withdrawalPauseRatio":{"type":"boolean","enum":[true],"description":"Include ratio of time the vault withdrawals were paused over the last 2 years. Returns null when the protocol does not expose a withdrawal-pause event source or the underlying tracked event has not yet been backfilled."},"composition":{"type":"boolean","enum":[true],"description":"Include composition for the vault."}},"additionalProperties":false,"description":"Choose which analytics sections to include in the response. Pricing scales with the selection."}},"additionalProperties":false,"description":"Request body for the advanced-analytics list endpoint. Use `select` to opt into per-item analytics sections."}}},"description":"Request body for the advanced-analytics list endpoint. Use `select` to opt into per-item analytics sections."},"parameters":[{"schema":{"type":"string","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"]},"in":"path","name":"network","required":true,"description":"Include only vaults with provided network(name or CAIP)"},{"schema":{"type":"string"},"in":"path","name":"vaultId","required":true,"description":"Vault id of the vault for which the data will be returned"}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"vaultId":{"type":"string"},"network":{"type":"string"},"maxDrawdown":{"type":"object","properties":{"mdd30days":{"type":"number","description":"Largest observed peak-to-trough drop in the vault price per share over the last 30 days, reported as a decimal (e.g. 0.12 = 12%)."},"mdd90days":{"type":"number","description":"Largest observed peak-to-trough drop in the vault price per share over the last 90 days, reported as a decimal (e.g. 0.12 = 12%)."},"mdd365days":{"type":"number","description":"Largest observed peak-to-trough drop in the vault price per share over the last 365 days, reported as a decimal (e.g. 0.12 = 12%)."}},"required":["mdd30days","mdd90days","mdd365days"],"additionalProperties":false,"description":"Max drawdown metrics for vault price per share"},"detailedVault":{"type":"object","properties":{"vaultId":{"type":"string","description":"Stable vault identity for API lookups and links"},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the vault"},"name":{"type":"string","description":"Name of the vault"},"network":{"type":"object","properties":{"name":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","robinhood"],"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"}},"required":["name","chainId","networkCaip"],"additionalProperties":false,"description":"Network details of the vault"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Asset details of the vault"},"isTransactional":{"type":"boolean","description":"Indicates if the vault supports transactional endpoints"},"isAppFeatured":{"type":"boolean","description":"Indicates if the vault is featured in app.vaults.fyi"},"protocol":{"type":"object","properties":{"name":{"type":"string","description":"Name of the protocol"},"displayName":{"type":"string","description":"Display name of the protocol"},"product":{"type":"string","description":"Product of the protocol"},"version":{"type":"string","description":"Version of the protocol"},"protocolUrl":{"type":"string","description":"URL of the protocol"},"description":{"type":"string","description":"Description of the protocol"},"protocolLogo":{"type":"string","description":"URL of the protocol logo"}},"required":["name"],"additionalProperties":false,"description":"Protocol details of the vault"},"lendUrl":{"type":"string","description":"URL to lend the asset"},"description":{"type":"string","description":"Description of the vault"},"protocolVaultUrl":{"type":"string","description":"URL to the protocol vault"},"tags":{"type":"array","items":{"type":"string","minLength":1},"description":"Tags of the vault"},"holdersData":{"type":"object","properties":{"totalCount":{"type":"number","description":"Number of holders of the vault"},"totalBalance":{"type":"string","description":"Total balance of the vault holders"},"topHolders":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the holder"},"lpTokenBalance":{"type":"string","description":"Balance of the LP token of the holder"}},"required":["address","lpTokenBalance"],"additionalProperties":false},"description":"Top holders of the vault"}},"additionalProperties":false},"apy":{"type":"object","properties":{"1day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1day APY details"},"7day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"7day APY details"},"30day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"30day APY details"},"1hour":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1hour APY details"}},"required":["1day","7day","30day","1hour"],"additionalProperties":false,"description":"APY details of the vault"},"tvl":{"type":"object","properties":{"usd":{"type":"string","description":"TVL in USD"},"native":{"type":"string","description":"Native TVL"}},"required":["usd","native"],"additionalProperties":false,"description":"TVL details of the vault"},"lastUpdateTimestamp":{"type":"integer","description":"Timestamp of the last vault data update"},"creationData":{"type":"object","properties":{"deploymentTimestamp":{"type":"integer","description":"Timestamp of the vault contract deployment block"}},"required":["deploymentTimestamp"],"additionalProperties":false,"description":"Vault contract creation data"},"rewards":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Asset details of the reward"},"apy":{"type":"object","properties":{"1hour":{"type":"number","description":"1hour APY of the reward asset"},"1day":{"type":"number","description":"1day APY of the reward asset"},"7day":{"type":"number","description":"7day APY of the reward asset"},"30day":{"type":"number","description":"30day APY of the reward asset"}},"required":["1hour","1day","7day","30day"],"additionalProperties":false}},"required":["asset","apy"],"additionalProperties":false},"description":"List of rewards for the vault"},"score":{"type":"object","properties":{"vaultScore":{"type":"number","description":"Score of the vault"},"vaultTvlScore":{"type":"number","description":"TVL score of the vault"},"protocolTvlScore":{"type":"number","description":"TVL score of the protocol"},"holderScore":{"type":"number","description":"Holder score of the vault"},"networkScore":{"type":"number","description":"Network score of the vault"},"assetScore":{"type":"number","description":"Asset score of the vault"},"totalScorePenalty":{"type":"number","description":"Penalty applied to the vault score"},"penaltyComponents":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"content":{"type":"string","description":"Content of the flag"},"severity":{"type":"string","enum":["info","warning","critical"],"description":"Severity level of the flag"},"endDate":{"type":"number","description":"Unix timestamp (seconds) when this flag expires"},"resolution":{"type":"string","description":"Resolution details if the flag has been resolved"},"type":{"type":"string","enum":["flag"],"description":"Type of the penalty component"},"value":{"type":"number","description":"Value of the penalty component, e.g., flag penalty or score factor penalty"}},"required":["content","severity","endDate","type","value"],"additionalProperties":false,"description":"Penalty component derived from a flag"},{"type":"object","properties":{"type":{"type":"string","description":"Type of the penalty component, e.g., score factor penalty"},"value":{"type":"number","description":"Value of the score factor penalty, e.g., 0.1 for a 10% penalty"}},"required":["type","value"],"additionalProperties":false,"description":"Penalty component derived from a score factor"}]},"description":"List of penalty components applied to the vault score"}},"required":["vaultScore","vaultTvlScore","protocolTvlScore","holderScore","networkScore","assetScore","totalScorePenalty","penaltyComponents"],"additionalProperties":false,"description":"Score details of the vault"},"additionalIncentives":{"type":"string","description":"Additional incentives of the vault"},"curator":{"type":"object","properties":{"name":{"type":"string","description":"Name of the curator"},"description":{"type":"string","description":"Description of the curator"},"websiteUrl":{"type":"string","description":"Website URL of the curator"}},"required":["name"],"additionalProperties":false,"description":"Curator of the vault"},"lpToken":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the LP token"},"tokenCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the LP token"},"name":{"type":"string","description":"Name of the LP token"},"symbol":{"type":"string","description":"Symbol of the LP token"},"decimals":{"type":"integer","description":"Number of decimals of the LP token"}},"required":["address","tokenCaip","name","symbol","decimals"],"additionalProperties":false,"description":"LP token details of the vault"},"remainingCapacity":{"type":"string","description":"Remaining capacity of the vault"},"maxCapacity":{"type":"string","description":"Maximum capacity limit of the vault"},"isCorrupted":{"type":"boolean","description":"Indicates if the vault is corrupted"},"userEventsIndexed":{"type":"boolean","description":"Indicates if user events related to the vault are indexed and available in the API"},"childrenVaults":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string","description":"Vault id of the child vault"},"address":{"type":"string","description":"Address of the child vault"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Asset details of the child vault"},"lpToken":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the LP token"},"tokenCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the LP token"},"name":{"type":"string","description":"Name of the LP token"},"symbol":{"type":"string","description":"Symbol of the LP token"},"decimals":{"type":"integer","description":"Number of decimals of the LP token"}},"required":["address","tokenCaip","name","symbol","decimals"],"additionalProperties":false,"description":"LP token details of the child vault"},"additionalAssets":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false},"description":"Additional assets of the child vault"}},"required":["vaultId","address","asset"],"additionalProperties":false},"description":"List of child vaults"},"additionalAssets":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false},"description":"Additional assets of the vault"},"transactionalProperties":{"type":"object","properties":{"depositStepsType":{"type":"string","enum":["instant","complex"],"description":"Type of transaction steps, either \"instant\" or \"complex\""},"redeemStepsType":{"type":"string","enum":["instant","complex"],"description":"Type of transaction steps, either \"instant\" or \"complex\""},"rewardsSupported":{"type":"boolean","description":"Indicates if the vault supports rewards transaction flows"}},"required":["depositStepsType","redeemStepsType","rewardsSupported"],"additionalProperties":false,"description":"Transactional properties of the vault"},"fees":{"type":"object","properties":{"performanceFee":{"type":"number","description":"Performance fee as decimal"},"managementFee":{"type":"number","description":"Management fee as decimal"},"withdrawalFee":{"type":"number","description":"Withdrawal fee as decimal"},"depositFee":{"type":"number","description":"Deposit fee as decimal"}},"additionalProperties":false,"description":"Fee structure of the vault"},"warnings":{"type":"array","items":{"type":"string"},"description":"List of warnings related to the vault"},"flags":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"Content of the flag"},"severity":{"type":"string","enum":["info","warning","critical"],"description":"Severity level of the flag"},"endDate":{"type":"number","description":"Unix timestamp (seconds) when this flag expires"},"resolution":{"type":"string","description":"Resolution details if the flag has been resolved"}},"required":["content","severity","endDate"],"additionalProperties":false},"description":"List of flags with severity and expiry information"},"apyComposite":{"type":"object","properties":{"totalApy":{"type":"object","properties":{"1day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1day APY details"},"7day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"7day APY details"},"30day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"30day APY details"},"1hour":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1hour APY details"}},"required":["1day","7day","30day","1hour"],"additionalProperties":false,"description":"Compounded APY details combining the vault and its underlying vault"},"intrinsicApy":{"type":"object","properties":{"1day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1day APY details"},"7day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"7day APY details"},"30day":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"30day APY details"},"1hour":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"1hour APY details"}},"required":["1day","7day","30day","1hour"],"additionalProperties":false,"description":"APY details of the underlying vault before compounding"},"asset":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the asset"},"assetCaip":{"type":"string","pattern":"^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$","description":"CAIP-2 of the asset"},"name":{"type":"string","description":"Name of the asset"},"symbol":{"type":"string","description":"Symbol of the asset"},"decimals":{"type":"integer","description":"Number of decimals of the asset"},"assetLogo":{"type":"string","format":"uri","description":"URL of the asset logo"},"assetPriceInUsd":{"type":"string","description":"Price of the asset in USD"},"assetGroup":{"type":"string","description":"Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"}},"required":["address","assetCaip","name","symbol","decimals","assetGroup"],"additionalProperties":false,"description":"Asset details of the underlying vault"},"vault":{"type":"object","properties":{"vaultId":{"type":"string","description":"Vault id of the underlying vault"},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address of the underlying vault"}},"required":["vaultId","address"],"additionalProperties":false}},"required":["totalApy","intrinsicApy","asset","vault"],"additionalProperties":false,"description":"Composite APY data when vault asset is another vault LP token. When present, totalApy compounds the current vault with the underlying vault and intrinsicApy shows the underlying vault's own APY"}},"required":["vaultId","address","name","network","asset","isTransactional","isAppFeatured","protocol","tags","holdersData","apy","tvl","lastUpdateTimestamp","creationData","rewards","isCorrupted","userEventsIndexed","warnings","flags"],"additionalProperties":false},"withdrawalPauseRatio":{"type":"number","nullable":true,"description":"Ratio (0-1) of time the vault withdrawals were paused over the last 2 years. Null when the protocol has no withdrawal-pause event source or the tracked event has not yet been backfilled."},"composition":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifier for the investment"},"supplyAssets":{"type":"string","description":"Amount of underlying assets supplied to the investment by the vault"},"allocation":{"type":"number","description":"Percentage allocation of the whole vault in investment, as a decimal (e.g. 0.12 = 12%)"},"name":{"type":"string","description":"Name of the investment"},"type":{"type":"string","enum":["market","idle"],"description":"Whether the composition item is a Morpho market or idle vault assets"}},"required":["id","supplyAssets","allocation","name","type"],"additionalProperties":false},"nullable":true,"description":"List of investments the vault is allocated to, with allocation percentages."}},"required":["vaultId","network"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","payTo","maxTimeoutSeconds","asset"],"additionalProperties":false}},{}]},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits"]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}}}}}},"servers":[{"url":"https://api.vaults.fyi","description":"Vaults.fyi Alpha API"}],"tags":[{"name":"Cross Chain"},{"name":"CCTP Bridge"},{"name":"Holders"},{"name":"Advanced Analytics"},{"name":"Historical Positions"}]}