Recent Swaps

curl --request GET \
  --url https://api.hadron.fi/pools/{address}/swaps

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hadron.fi/pools/{address}/swaps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hadron.fi/pools/{address}/swaps"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hadron.fi/pools/{address}/swaps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "signature": "5ZVLukBf3HfmT7d9Emte1fobjhtHsjps5TXtNZboTK3di76NbVUxHsLDFuzcnyhnjYLNnVdJajKg9k5NJCs9CLCi",
      "timestamp": 1773239448,
      "slot": 405713180,
      "direction": "buy",
      "input_amount": 86476334,
      "output_amount": 998378024,
      "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "output_mint": "So11111111111111111111111111111111111111112",
      "midprice_at_swap": 0.08647878072224557,
      "execution_price_at_swap": 0.08662,
      "base_spread_factor_at_swap": 0.9995,
      "vault_x_after": 5413038034,
      "vault_y_after": 515256215,
      "fees": {
        "protocol_fee_quote_raw": 0,
        "protocol_fee_raw": 0,
        "protocol_fee_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "realized_spread_quote_raw": 142136,
        "realized_spread_bps": 16.44,
        "protocol_fee_split": null
      }
    },
    {
      "signature": "4b76z7T6gqn5aNjvDN3eE4X9dLrdR88DNYomkugjRvExxLRrYAgumaoGbzN8NYPFXvoXaeM9bbmD6P2tp5aTT2Tn",
      "timestamp": 1773239444,
      "slot": 405713171,
      "direction": "sell",
      "input_amount": 1000000000,
      "output_amount": 86347675,
      "input_mint": "So11111111111111111111111111111111111111112",
      "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "midprice_at_swap": 0.08649538387544453,
      "execution_price_at_swap": 0.08634768,
      "base_spread_factor_at_swap": 0.9995,
      "vault_x_after": 6411416058,
      "vault_y_after": 428792852,
      "fees": {
        "protocol_fee_quote_raw": 0,
        "protocol_fee_raw": 0,
        "protocol_fee_mint": "So11111111111111111111111111111111111111112",
        "realized_spread_quote_raw": 147709,
        "realized_spread_bps": 17.08,
        "protocol_fee_split": null
      }
    }
  ],
  "next_cursor": "eyJpZCI6ImozZDd4a203...",
  "has_more": true
}

GET

pools

{address}

swaps

Recent Swaps

curl --request GET \
  --url https://api.hadron.fi/pools/{address}/swaps

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hadron.fi/pools/{address}/swaps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hadron.fi/pools/{address}/swaps"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hadron.fi/pools/{address}/swaps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "signature": "5ZVLukBf3HfmT7d9Emte1fobjhtHsjps5TXtNZboTK3di76NbVUxHsLDFuzcnyhnjYLNnVdJajKg9k5NJCs9CLCi",
      "timestamp": 1773239448,
      "slot": 405713180,
      "direction": "buy",
      "input_amount": 86476334,
      "output_amount": 998378024,
      "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "output_mint": "So11111111111111111111111111111111111111112",
      "midprice_at_swap": 0.08647878072224557,
      "execution_price_at_swap": 0.08662,
      "base_spread_factor_at_swap": 0.9995,
      "vault_x_after": 5413038034,
      "vault_y_after": 515256215,
      "fees": {
        "protocol_fee_quote_raw": 0,
        "protocol_fee_raw": 0,
        "protocol_fee_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "realized_spread_quote_raw": 142136,
        "realized_spread_bps": 16.44,
        "protocol_fee_split": null
      }
    },
    {
      "signature": "4b76z7T6gqn5aNjvDN3eE4X9dLrdR88DNYomkugjRvExxLRrYAgumaoGbzN8NYPFXvoXaeM9bbmD6P2tp5aTT2Tn",
      "timestamp": 1773239444,
      "slot": 405713171,
      "direction": "sell",
      "input_amount": 1000000000,
      "output_amount": 86347675,
      "input_mint": "So11111111111111111111111111111111111111112",
      "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "midprice_at_swap": 0.08649538387544453,
      "execution_price_at_swap": 0.08634768,
      "base_spread_factor_at_swap": 0.9995,
      "vault_x_after": 6411416058,
      "vault_y_after": 428792852,
      "fees": {
        "protocol_fee_quote_raw": 0,
        "protocol_fee_raw": 0,
        "protocol_fee_mint": "So11111111111111111111111111111111111111112",
        "realized_spread_quote_raw": 147709,
        "realized_spread_bps": 17.08,
        "protocol_fee_split": null
      }
    }
  ],
  "next_cursor": "eyJpZCI6ImozZDd4a203...",
  "has_more": true
}

Path Parameters

string

required

The pool config PDA address.

Query Parameters

integer

default:"50"

Page size — number of swaps to return per request. Maximum 200.

string

Opaque pagination cursor. Omit on the first request; on subsequent requests, pass the next_cursor value from the previous response to fetch the next page. When the server returns next_cursor: null (equivalently has_more: false), you have reached the end of the pool’s history.

string

default:"mainnet-beta"

Solana cluster — mainnet-beta or devnet.

Response

array

Array of swap events on this page, ordered by most recent first.

Show Swap event

string

Solana transaction signature.

integer

Swap timestamp (Unix seconds).

integer

Solana slot number.

string

Swap direction — buy (Y to X) or sell (X to Y).

integer

Raw input token amount.

integer

Raw output token amount.

string

Input token mint address.

string

Output token mint address.

number

The pool midprice at the time of the swap (raw Q32-decoded value).

number

Effective execution price in Y-per-X terms, excluding the protocol fee. Directly comparable to midprice_at_swap.

number | null

The pool’s base spread factor read from the oracle at the time of the swap. 1.0 means no base spread; e.g. 0.9995 means the LP charged ≈5 bps of base spread before any inventory skew. Values above 1.0 indicate the curve was skewed in the trader’s favor (the LP gave up base spread to rebalance inventory) — this is the conceptual fee the LP is still earning even when realized_spread_quote_raw is negative. null for swaps recorded before this field was tracked.

integer

Vault X balance after the swap.

integer

Vault Y balance after the swap.

object

Fee and execution quality metrics for the swap.

Show Fees

number

Protocol fee in raw Y (quote-side) atoms. For sell swaps (fee paid in X), converted to Y-equivalent using midprice.

number

Protocol fee in raw atoms of the fee token (the swap’s input token — X on a sell, Y on a buy). Unlike protocol_fee_quote_raw, this is not midprice-converted.

string

Mint of the fee token (equals input_mint).

number

Spread captured by the pool in raw Y (quote-side) atoms. Positive values indicate pool profit; negative values indicate the trade executed better than midprice. For buy swaps this is a Y-equivalent conversion of the X atoms the pool saved.

number

Spread captured by the pool in basis points of the trade’s notional value at midprice. Unit-independent — directly comparable across pools and directions.

array | null

Per-recipient breakdown of the protocol fee for pools whose fee routes through the fee-split sidecar. null for pools that use the default (single) fee recipient, and for swaps recorded before this field was tracked.Amounts are exact proportional shares of protocol_fee_raw (protocol_fee_raw × ppm / Σ ppm) — they sum to protocol_fee_raw. The split ratio is captured at the swap’s slot, so it is exact even if the pool’s recipient weights change later.

Show Recipient

string

Recipient wallet address.

integer

Recipient’s split weight in parts-per-million, as configured on-chain at the time of the swap. The denominator is the sum of all recipients’ ppm (not a fixed 1,000,000).

number

Recipient’s share of protocol_fee_raw, in fee-token atoms.

string | null

Cursor to pass as ?cursor=... on the next request to fetch the following page. null when there are no more swaps (end of history).

boolean

true if more swaps are available beyond this page, false if this is the last page.

{
  "data": [
    {
      "signature": "5ZVLukBf3HfmT7d9Emte1fobjhtHsjps5TXtNZboTK3di76NbVUxHsLDFuzcnyhnjYLNnVdJajKg9k5NJCs9CLCi",
      "timestamp": 1773239448,
      "slot": 405713180,
      "direction": "buy",
      "input_amount": 86476334,
      "output_amount": 998378024,
      "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "output_mint": "So11111111111111111111111111111111111111112",
      "midprice_at_swap": 0.08647878072224557,
      "execution_price_at_swap": 0.08662,
      "base_spread_factor_at_swap": 0.9995,
      "vault_x_after": 5413038034,
      "vault_y_after": 515256215,
      "fees": {
        "protocol_fee_quote_raw": 0,
        "protocol_fee_raw": 0,
        "protocol_fee_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "realized_spread_quote_raw": 142136,
        "realized_spread_bps": 16.44,
        "protocol_fee_split": null
      }
    },
    {
      "signature": "4b76z7T6gqn5aNjvDN3eE4X9dLrdR88DNYomkugjRvExxLRrYAgumaoGbzN8NYPFXvoXaeM9bbmD6P2tp5aTT2Tn",
      "timestamp": 1773239444,
      "slot": 405713171,
      "direction": "sell",
      "input_amount": 1000000000,
      "output_amount": 86347675,
      "input_mint": "So11111111111111111111111111111111111111112",
      "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "midprice_at_swap": 0.08649538387544453,
      "execution_price_at_swap": 0.08634768,
      "base_spread_factor_at_swap": 0.9995,
      "vault_x_after": 6411416058,
      "vault_y_after": 428792852,
      "fees": {
        "protocol_fee_quote_raw": 0,
        "protocol_fee_raw": 0,
        "protocol_fee_mint": "So11111111111111111111111111111111111111112",
        "realized_spread_quote_raw": 147709,
        "realized_spread_bps": 17.08,
        "protocol_fee_split": null
      }
    }
  ],
  "next_cursor": "eyJpZCI6ImozZDd4a203...",
  "has_more": true
}

For a pool whose protocol fee routes through the fee-split sidecar, the fees object includes a populated protocol_fee_split (shares sum to protocol_fee_raw):

"fees": {
  "protocol_fee_quote_raw": 12500,
  "protocol_fee_raw": 12500,
  "protocol_fee_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "realized_spread_quote_raw": 142136,
  "realized_spread_bps": 16.44,
  "protocol_fee_split": [
    { "recipient": "Rec1", "ppm": 700000, "amount_raw": 8750 },
    { "recipient": "Rec2", "ppm": 300000, "amount_raw": 3750 }
  ]
}

Overview

Pools

Stats

Recent Swaps

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response