Get Pool Swaps

curl --request GET \
  --url https://api.amm.flashnet.xyz/v1/pools/{lpPubkey}/swaps

{
  "swaps": [
    {
      "amountIn": "1000000",
      "amountOut": "500000",
      "assetInAddress": "66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17",
      "assetOutAddress": "020202020202020202020202020202020202020202020202020202020202020202",
      "createdAt": "2025-01-15T10:30:00Z",
      "feePaid": "5000",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "inboundTransferId": "550e8400-e29b-41d4-a716-446655440001",
      "outboundTransferId": "550e8400-e29b-41d4-a716-446655440001",
      "price": "0.5",
      "swapperPublicKey": "03a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890"
    }
  ],
  "totalCount": 150
}

Swaps

Get Pool Swaps

This endpoint retrieves all swap transactions that have occurred in a pool, sorted by most recent first. It provides comprehensive details about each swap including amounts, prices, fees, and participants.

Response Data

Each swap event includes:

Unique swap identifier
Swapper’s public key
Input/output amounts and assets
Execution price
Fees paid
Timestamp

Pagination

Results are paginated to handle pools with extensive trading history:

Use limit to control page size (max 100)
Use offset to navigate through pages
totalCount indicates total swaps available

Sorting

Swaps are always returned in reverse chronological order (newest first) to show the most recent activity.

Arguments

lpPubkey - The LP public key of the pool
limit - Maximum swaps per page (1-100, default: 20)
offset - Number of swaps to skip (default: 0)

Returns

200 OK with paginated swap list and total count
404 Not Found if pool doesn’t exist
500 Internal Server Error if retrieval fails

GET

pools

{lpPubkey}

swaps

Get Pool Swaps

curl --request GET \
  --url https://api.amm.flashnet.xyz/v1/pools/{lpPubkey}/swaps

{
  "swaps": [
    {
      "amountIn": "1000000",
      "amountOut": "500000",
      "assetInAddress": "66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17",
      "assetOutAddress": "020202020202020202020202020202020202020202020202020202020202020202",
      "createdAt": "2025-01-15T10:30:00Z",
      "feePaid": "5000",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "inboundTransferId": "550e8400-e29b-41d4-a716-446655440001",
      "outboundTransferId": "550e8400-e29b-41d4-a716-446655440001",
      "price": "0.5",
      "swapperPublicKey": "03a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890"
    }
  ],
  "totalCount": 150
}

Path Parameters

lpPubkey

string

required

The LP public key identifying the pool

Query Parameters

limit

integer<int32> | null

default:20

Maximum number of swaps to return in the response. Helps manage response size for pools with many swaps.

Required range: 1 <= x <= 100

offset

integer<int64> | null

default:0

Number of swaps to skip before starting to collect results. Used for paginating through large result sets.

Required range: x >= 0

startTime

string | null

Start timestamp (inclusive) in RFC3339 format.

endTime

string | null

End timestamp (inclusive) in RFC3339 format.

Response

Swap history retrieved successfully

Response for listing pool swaps

swaps

object[]

required

List of swap events

Show child attributes

swaps.id

string

required

Swap ID

Example:

"550e8400-e29b-41d4-a716-446655440000"

swaps.swapperPublicKey

string

required

Public key of the user who executed the swap

Example:

"03a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890"

swaps.amountIn

integer

required

Amount of input asset swapped

Required range: x >= 0

Example:

"1000000"

swaps.amountOut

integer

required

Amount of output asset received

Required range: x >= 0

Example:

"500000"

swaps.assetInAddress

string

required

Input asset public key

Example:

"66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17"

swaps.assetOutAddress

string

required

Output asset public key

Example:

"020202020202020202020202020202020202020202020202020202020202020202"

swaps.createdAt

string

required

Timestamp in ISO 8601 format

Example:

"2025-01-15T10:30:00Z"

swaps.feePaid

integer

required

Fee paid for the swap

Required range: x >= 0

Example:

"5000"

swaps.inboundTransferId

string

required

Inbound transfer ID (UUID or SHA256 hash)

Example:

"550e8400-e29b-41d4-a716-446655440001"

swaps.outboundTransferId

string

required

Outbound transfer ID (UUID for sats or "TOKEN" for tokens)

Example:

"TOKEN"

swaps.price

string | null

Execution price

Example:

"0.5"

totalCount

integer<int64>

required

Total count of swaps (for pagination)

Example:

150

Get LP Position

Execute Route Swap

⌘I

Auth

Clawback

Hosts

Integrators

Liquidity

Status

Pools

Swaps

Get Pool Swaps

Response Data

Pagination

Sorting

Arguments

Returns

Path Parameters

Query Parameters

Response