Get Liquidity Positions

curl --request GET \
  --url https://api.amm.flashnet.xyz/v1/liquidity/positions \
  --header 'Authorization: Bearer <token>'

{
  "lpPublicKey": "03fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210",
  "positions": [
    {
      "assetAAddress": "03abcdef123...",
      "assetAAmount": "500000",
      "assetBAddress": "03fedcba321...",
      "assetBAmount": "250000",
      "lpFeeRateBps": 100,
      "lpTokenSupply": "1000000000000",
      "poolId": "03aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899",
      "userLpTokens": "100000000",
      "userShareOfPoolPercent": 10
    }
  ]
}

Liquidity

Get Liquidity Positions

This endpoint allows an authenticated user to retrieve all of their liquidity provider (LP) positions across all AMM pools.

Authentication & Authorization

The authenticated token’s public key identifies the user whose LP positions are being queried.

Response

The response includes a list of all pools where the user has provided liquidity, detailing their share of each pool and the underlying asset amounts. All amounts are returned in their smallest unit (e.g., satoshis).

Returns

200 OK with a list of LP positions.
401 Unauthorized if authentication fails.
500 Internal Server Error if there is a problem retrieving the data.

GET

liquidity

positions

Get Liquidity Positions

curl --request GET \
  --url https://api.amm.flashnet.xyz/v1/liquidity/positions \
  --header 'Authorization: Bearer <token>'

{
  "lpPublicKey": "03fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210",
  "positions": [
    {
      "assetAAddress": "03abcdef123...",
      "assetAAmount": "500000",
      "assetBAddress": "03fedcba321...",
      "assetBAmount": "250000",
      "lpFeeRateBps": 100,
      "lpTokenSupply": "1000000000000",
      "poolId": "03aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899",
      "userLpTokens": "100000000",
      "userShareOfPoolPercent": 10
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Successfully retrieved LP positions

Response containing all of a user's liquidity positions.

lpPublicKey

string

required

The public key of the liquidity provider.

Example:

"03fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210"

positions

object[]

required

A list of the user's liquidity positions.

Show child attributes

positions.poolId

string

required

The public key of the AMM pool.

Example:

"03aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899"

positions.lpFeeRateBps

integer<uint32>

required

The LP Fee rate in basis points.

Required range: x >= 0

Example:

100

positions.assetAAddress

string

required

Asset A public key.

Example:

"03abcdef123..."

positions.assetBAddress

string

required

Asset B public key.

Example:

"03fedcba321..."

positions.lpTokenSupply

integer

required

The total supply of LP tokens for the pool.

Required range: x >= 0

Example:

"1000000000000"

positions.userLpTokens

integer

required

The user's balance of LP tokens.

Required range: x >= 0

Example:

"100000000"

The user's share of the pool, as a percentage.

Example:

10

positions.assetAAmount

integer

required

The amount of Asset A underlying the user's LP tokens.

Required range: x >= 0

Example:

"500000"

positions.assetBAmount

integer

required

The amount of Asset B underlying the user's LP tokens.

Required range: x >= 0

Example:

"250000"

Simulate Add Liquidity

Remove Liquidity

⌘I

Auth

Clawback

Hosts

Integrators

Liquidity

Status

Pools

Swaps

Get Liquidity Positions

Authentication & Authorization

Response

Returns

Authorizations

Response