Get Swaps

curl --request GET \
  --url https://api.amm.flashnet.xyz/v1/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",
      "poolAssetAAddress": "66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17",
      "poolAssetBAddress": "020202020202020202020202020202020202020202020202020202020202020202",
      "poolLpPublicKey": "0315299b3f9f4e2beb8576ea2bf72ea1bc741eb255bfc3f6387de4d47b5c05972d",
      "poolType": "CONSTANT_PRODUCT",
      "price": "0.5",
      "swapperPublicKey": "03a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890"
    }
  ],
  "totalCount": 1500
}

Swaps

Get Swaps

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

Response Data

Each swap event includes:

Unique swap identifier
Pool LP public key and type
Swapper’s public key
Input/output amounts and assets
Execution price
Fees paid
Timestamp
Pool assets (for context)

Pagination

Results are paginated to handle the potentially massive number of swaps:

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

Filtering

Optional filters to narrow down results:

poolType: Show only swaps from specific pool types
assetAddress: Show only swaps involving a specific asset

Sorting

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

Arguments

limit - Maximum swaps per page (1-100, default: 20)
offset - Number of swaps to skip (default: 0)
poolType - Optional filter by pool type
assetAddress - Optional filter by asset address

Returns

200 OK with paginated swap list and total count
500 Internal Server Error if retrieval fails

GET

swaps

Get Swaps

curl --request GET \
  --url https://api.amm.flashnet.xyz/v1/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",
      "poolAssetAAddress": "66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17",
      "poolAssetBAddress": "020202020202020202020202020202020202020202020202020202020202020202",
      "poolLpPublicKey": "0315299b3f9f4e2beb8576ea2bf72ea1bc741eb255bfc3f6387de4d47b5c05972d",
      "poolType": "CONSTANT_PRODUCT",
      "price": "0.5",
      "swapperPublicKey": "03a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890"
    }
  ],
  "totalCount": 1500
}

Query Parameters

limit

integer<int32> | null

default:20

Maximum number of swaps to return in the response. Helps manage response size when dealing with large swap volumes.

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

poolType

string | null

Filter by pool type (CONSTANT_PRODUCT or SINGLE_SIDED). If not specified, returns swaps from all pool types.

assetAddress

string | null

Filter by asset address (will match either input or output asset). Useful for finding all swaps involving a specific asset.

startTime

string | null

Start timestamp (inclusive) in RFC3339 format.

endTime

string | null

End timestamp (inclusive) in RFC3339 format.

Response

Global swap history retrieved successfully

Response for listing global 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.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.poolType

string

required

Pool type (CONSTANT_PRODUCT or SINGLE_SIDED)

Example:

"CONSTANT_PRODUCT"

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 of swaps (for pagination)

Example:

1500

Simulate Swap

Get User Swaps

⌘I

Auth

Clawback

Hosts

Integrators

Liquidity

Status

Pools

Swaps

Get Swaps

Response Data

Pagination

Filtering

Sorting

Arguments

Returns

Query Parameters

Response