Get User Swaps

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

{
  "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",
      "poolAssetAAddress": "66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17",
      "poolAssetBAddress": "020202020202020202020202020202020202020202020202020202020202020202",
      "poolLpPublicKey": "0315299b3f9f4e2beb8576ea2bf72ea1bc741eb255bfc3f6387de4d47b5c05972d",
      "price": "0.5"
    }
  ],
  "totalCount": 25
}

Swaps

Get User Swaps

This endpoint retrieves all swap transactions executed by a user across all pools. It supports comprehensive filtering and sorting options to help users analyze their trading history.

Filtering Options

By Pool: Filter swaps from specific pools
By Assets: Filter by input or output assets
By Amount: Set minimum/maximum trade sizes
By Time: Specify date ranges for historical data

Sorting Options

Results can be sorted by:

Timestamp (newest/oldest first)
Input amount (highest/lowest first)
Output amount (highest/lowest first)

Response Data

Each swap includes pool context to help identify where trades occurred, making it easier to analyze performance across different pools.

Arguments

userPublicKey - The public key of the user
poolLpPubkey - Optional filter by pool LP public key
assetInTokenPublicKey - Optional filter by input asset
assetOutTokenPublicKey - Optional filter by output asset
minAmountIn - Optional minimum input amount filter
maxAmountIn - Optional maximum input amount filter
startTime - Optional start time (RFC3339 format)
endTime - Optional end time (RFC3339 format)
sort - Sort order for results
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 user doesn’t exist
500 Internal Server Error if retrieval fails

GET

swaps

user

{userPublicKey}

Get User Swaps

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

{
  "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",
      "poolAssetAAddress": "66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17",
      "poolAssetBAddress": "020202020202020202020202020202020202020202020202020202020202020202",
      "poolLpPublicKey": "0315299b3f9f4e2beb8576ea2bf72ea1bc741eb255bfc3f6387de4d47b5c05972d",
      "price": "0.5"
    }
  ],
  "totalCount": 25
}

Path Parameters

userPublicKey

string

required

The public key of the user whose swaps to retrieve

Query Parameters

poolLpPubkey

string | null

Filter by pool LP public key.

assetInAddress

string | null

Filter by asset in token public key.

assetOutAddress

string | null

Filter by asset out token public key.

minAmountIn

integer<int64> | null

Minimum amount in.

maxAmountIn

integer<int64> | null

Maximum amount in.

startTime

string | null

Start timestamp (inclusive) in RFC3339 format.

endTime

string | null

End timestamp (inclusive) in RFC3339 format.

sort

enum<string>

Sort order for results. Sort order for listing user swaps.

Available options:

timestampDesc,

timestampAsc,

amountInDesc,

amountInAsc,

amountOutDesc,

amountOutAsc

limit

integer<int32> | null

default:20

Maximum number of swaps to return.

Required range: 1 <= x <= 100

offset

integer<int64> | null

default:0

Number of swaps to skip before starting to collect the result set.

Required range: x >= 0

Response

User swap history retrieved successfully

Response for listing user swaps

swaps

object[]

required

List of swap events

Show child attributes

swaps.id

string

required

Swap ID

Example:

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

swaps.poolLpPublicKey

string

required

Pool LP public key

Example:

"0315299b3f9f4e2beb8576ea2bf72ea1bc741eb255bfc3f6387de4d47b5c05972d"

swaps.amountIn

integer

required

Amount of input asset

Required range: x >= 0

Example:

"1000000"

swaps.amountOut

integer

required

Amount of output asset

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.timestamp

string

required

Timestamp in ISO 8601 format

Example:

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

swaps.feePaid

integer

required

Fee paid

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"

swaps.poolAssetAAddress

string | null

Pool asset A public key (optional metadata)

swaps.poolAssetBAddress

string | null

Pool asset B public key (optional metadata)

totalCount

integer<int64>

required

Total count for pagination

Example:

25

Get Swaps

⌘I

Auth

Clawback

Hosts

Integrators

Liquidity

Status

Pools

Swaps

Get User Swaps

Filtering Options

Sorting Options

Response Data

Arguments

Returns

Path Parameters

Query Parameters

Response