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"
}

Get user positions by public key and filter

Retrieves positions associated with a user's public key based on a filter.

POSThttps://indexer-dev.saturnbtc.io/v0/user/positions/{pubkey}/by-filter

Path parameters

pubkey*string

• The user's public key in hexadecimal format.

Body

application/json

• The filter criteria for searching positions.

name*An array of token names to filter positions

An array of token names to filter positions.

minLiquidity*The minimum liquidity to filter positions

The minimum liquidity to filter positions.

sort*An array of sorting fields and directions

An array of sorting fields and directions.

limitinteger

offset*integer

Response

200

A paginated response containing an array of positions, serialized with BigInt values.

Body

application/json

response*array of object

offset*number

Request

JavaScriptCurlPython

const response = await fetch('https://indexer-dev.saturnbtc.io/v0/user/positions/{pubkey}/by-filter', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": [
        "text"
      ],
      "minLiquidity": "text",
      "sort": [
        {}
      ],
      "offset": 0
    }),
});
const data = await response.json();

Response

200

{
  "response": [
    {
      "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"
    }
  ],
  "offset": 0
}