Skip to main content
GET
/
alpha
/
borrow
/
portfolio
/
positions
/
{userAddress}
/
{network}
/
{marketId}
Get borrow market position
curl --request GET \
  --url https://api.vaults.fyi/alpha/borrow/portfolio/positions/{userAddress}/{network}/{marketId} \
  --header 'x-api-key: <api-key>'
{
  "marketId": "<string>",
  "name": "<string>",
  "network": {
    "chainId": 123,
    "networkCaip": "<string>"
  },
  "protocol": {
    "name": "<string>",
    "product": "<string>",
    "version": "<string>"
  },
  "userAddress": "<string>",
  "assets": [
    {
      "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

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}$
​
assets
object[]
required
​
ltv
number
Required range: x >= 0
​
healthFactor
number
Required range: x >= 0