Skip to main content
GET
/
alpha
/
borrow
/
portfolio
/
positions
/
{userAddress}
/
{network}
/
{marketId}
/
{assetAddress}
Get borrow market asset position
curl --request GET \
  --url https://api.vaults.fyi/alpha/borrow/portfolio/positions/{userAddress}/{network}/{marketId}/{assetAddress} \
  --header 'x-api-key: <api-key>'
{
  "marketId": "<string>",
  "name": "<string>",
  "network": {
    "chainId": 123,
    "networkCaip": "<string>"
  },
  "protocol": {
    "name": "<string>",
    "product": "<string>",
    "version": "<string>"
  },
  "userAddress": "<string>",
  "asset": {
    "asset": {
      "address": "<string>",
      "assetCaip": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "decimals": 123,
      "assetPriceInUsd": "<string>",
      "assetGroup": "<string>",
      "assetLogo": "<string>"
    },
    "collateralEnabled": true,
    "balanceNative": "<string>",
    "balanceUsd": 1,
    "suppliedNative": "<string>",
    "suppliedUsd": 1,
    "borrowedNative": "<string>",
    "borrowedUsd": 1
  },
  "ltv": 1,
  "healthFactor": 1
}

Documentation Index

Fetch the complete documentation index at: https://docs.vaults.fyi/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
userAddress
string
required

Address of the user whose borrow market positions are requested

Pattern: ^0x[a-fA-F0-9]{40}$
​
network
enum<string>
required

Canonical network slug

Available options:
mainnet,
optimism,
arbitrum,
polygon,
gnosis,
base,
unichain,
swellchain,
celo,
worldchain,
berachain,
ink,
bsc,
hyperliquid,
plasma,
avalanche,
katana,
linea,
mega-eth,
monad,
etherlink
​
marketId
string
required

Canonical market identifier

Minimum string length: 1
​
assetAddress
string
required

Canonical asset address within the borrow market

Pattern: ^0x[a-fA-F0-9]{40}$

Response

Default Response

​
marketId
string
required
​
name
string
required
​
network
object
required
​
protocol
object
required
​
userAddress
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
​
asset
object
required
​
ltv
number
Required range: x >= 0
​
healthFactor
number
Required range: x >= 0