Users

Get user positions by public key

Retrieves all positions associated with a user's public key.

GEThttps://indexer-dev.saturnbtc.io/v0/user/positions/{pubkey}

Path parameters

pubkey*string

• The user's public key in hexadecimal format.
• Type: string
• Description: The public key identifying the user whose positions are being requested.
• Example: '02a1633caf...e4613f0f0f'

Response

200500

An array of positions with estimated yields, serialized with BigInt values.

• Type: PositionResult[]
• Description: An array of the user's positions, each including detailed statistics and estimated yield.

Body

application/json

poolStats*object

estimatedYield*string

id*string

pool_pubkey*string

owner*string

liquidity*string

Request

JavaScriptCurlPython

const response = await fetch('https://indexer-dev.saturnbtc.io/v0/user/positions/{pubkey}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200500

[
  {
    "poolStats": {
      "id": "text",
      "tvl_now": "text",
      "tvl_24h_ago": "text",
      "tvl_diff": "text",
      "volume_24h": "text",
      "volume_diff_24h": "text",
      "fees_24h": "text",
      "apy_24h": "text",
      "apy": "text",
      "volume_7d": "text",
      "fees_7d": "text",
      "apy_7d": "text",
      "price": "text",
      "token0Amount": "text",
      "token1Amount": "text",
      "token0": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": "text",
        "tradeable": false,
        "verified": false,
        "icon": "text",
        "priority": 0,
        "divisibility": 0,
        "supply": "text",
        "batchSize": "text",
        "transactionId": "text",
        "createdAt": "text"
      },
      "token1": {
        "id": "text",
        "name": "text",
        "displayName": "text",
        "symbol": "text",
        "tradeable": false,
        "verified": false,
        "icon": "text",
        "priority": 0,
        "divisibility": 0,
        "supply": "text",
        "batchSize": "text",
        "transactionId": "text",
        "createdAt": "text"
      },
      "liquidity": "text",
      "fee_rate": 0
    },
    "estimatedYield": "text",
    "id": "text",
    "pool_pubkey": "text",
    "owner": "text",
    "liquidity": "text"
  }
]

Get a user's position by public key and pool ID

Retrieves a specific position for a user by public key and pool ID.

GEThttps://indexer-dev.saturnbtc.io/v0/user/position/{pubkey}/{poolId}

Path parameters

pubkey*string

• The user's public key in hexadecimal format.
• Type: string
• Description: The public key identifying the user.
• Example: '02a1633caf...e4613f0f0f'

poolId*string

• The unique identifier of the liquidity pool.
• Type: string
• Description: The ID of the liquidity pool for which the user's position is requested.
• Example: '02a1633caf...e4613f0f0f'

Response

200404500

The position with estimated yield, serialized with BigInt values.

• Type: SerializeBigInt<PositionResult>
• Description: The user's position in the specified pool, including detailed statistics and estimated yield.

Body

application/json

poolStats*object

estimatedYield*string

id*string

pool_pubkey*string

owner*string

liquidity*string

Request

JavaScriptCurlPython

const response = await fetch('https://indexer-dev.saturnbtc.io/v0/user/position/{pubkey}/{poolId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200404500

{
  "poolStats": {
    "id": "text",
    "tvl_now": "text",
    "tvl_24h_ago": "text",
    "tvl_diff": "text",
    "volume_24h": "text",
    "volume_diff_24h": "text",
    "fees_24h": "text",
    "apy_24h": "text",
    "apy": "text",
    "volume_7d": "text",
    "fees_7d": "text",
    "apy_7d": "text",
    "price": "text",
    "token0Amount": "text",
    "token1Amount": "text",
    "token0": {
      "id": "text",
      "name": "text",
      "displayName": "text",
      "symbol": "text",
      "tradeable": false,
      "verified": false,
      "icon": "text",
      "priority": 0,
      "divisibility": 0,
      "supply": "text",
      "batchSize": "text",
      "transactionId": "text",
      "createdAt": "text"
    },
    "token1": {
      "id": "text",
      "name": "text",
      "displayName": "text",
      "symbol": "text",
      "tradeable": false,
      "verified": false,
      "icon": "text",
      "priority": 0,
      "divisibility": 0,
      "supply": "text",
      "batchSize": "text",
      "transactionId": "text",
      "createdAt": "text"
    },
    "liquidity": "text",
    "fee_rate": 0
  },
  "estimatedYield": "text",
  "id": "text",
  "pool_pubkey": "text",
  "owner": "text",
  "liquidity": "text"
}