Get live position equity and liquidation risk

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.testnet.tayho.io/v1/positions/{id}/risk', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://api.testnet.tayho.io/v1/positions/{id}/risk \
  --header 'X-API-Key: <api-key>'

{
  "equityWad": "<string>",
  "leverageWad": "<string>",
  "liquidatable": true,
  "liquidationPriceWad": "<string>",
  "maintenanceMarginWad": "<string>",
  "pendingFundingWad": "<string>",
  "positionId": "<string>",
  "previewFundingWad": "<string>",
  "validAtBlock": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

GET

positions

{id}

risk

Get live position equity and liquidation risk

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.testnet.tayho.io/v1/positions/{id}/risk', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://api.testnet.tayho.io/v1/positions/{id}/risk \
  --header 'X-API-Key: <api-key>'

{
  "equityWad": "<string>",
  "leverageWad": "<string>",
  "liquidatable": true,
  "liquidationPriceWad": "<string>",
  "maintenanceMarginWad": "<string>",
  "pendingFundingWad": "<string>",
  "positionId": "<string>",
  "previewFundingWad": "<string>",
  "validAtBlock": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "requestId": "<string>"
}

Authorizations

X-API-Key

string

header

required

Tayho project API key with the scope declared by the operation.

Path Parameters

string<tayho-uint256>

required

Maximum string length: 78

Response

Successful response.

equityWad

string

required

Pattern: ^-?(?:0|[1-9][0-9]*)$

leverageWad

string

required

Pattern: ^(?:0|[1-9][0-9]*)$

liquidatable

boolean

required

liquidationPriceWad

string

required

Pattern: ^(?:0|[1-9][0-9]*)$

maintenanceMarginWad

string

required

Pattern: ^(?:0|[1-9][0-9]*)$

pendingFundingWad

string

required

Pattern: ^-?(?:0|[1-9][0-9]*)$

positionId

string

required

Pattern: ^(?:0|[1-9][0-9]*)$

previewFundingWad

string

required

Pattern: ^-?(?:0|[1-9][0-9]*)$

validAtBlock

string

required

Pattern: ^(?:0|[1-9][0-9]*)$

Last modified on July 23, 2026

List canonical position events

List canonical position settlements

⌘I