Recent Swaps

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

import requests

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

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.hadron.fi/pools/{address}/swaps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?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))

}

HttpResponse<String> response = Unirest.get("https://api.hadron.fi/pools/{address}/swaps")
  .asString();

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

import requests

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

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.hadron.fi/pools/{address}/swaps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?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))

}

HttpResponse<String> response = Unirest.get("https://api.hadron.fi/pools/{address}/swaps")
  .asString();

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

address

string

required

The pool config PDA address.

Query Parameters

limit

integer

default:"50"

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

cursor

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.

cluster

string

default:"mainnet-beta"

Solana cluster — mainnet-beta or devnet.

Response

data

array

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

Show Swap event

signature

string

Solana transaction signature.

timestamp

integer

Swap timestamp (Unix seconds).

slot

integer

Solana slot number.

direction

string

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

input_amount

integer

Raw input token amount.

output_amount

integer

Raw output token amount.

input_mint

string

Input token mint address.

output_mint

string

Output token mint address.

midprice_at_swap

number

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

execution_price_at_swap

number

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

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

vault_x_after

integer

Vault X balance after the swap.

vault_y_after

integer

Vault Y balance after the swap.

fees

object

Fee and execution quality metrics for the swap.

Show Fees

protocol_fee_quote_raw

number

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

protocol_fee_raw

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.

protocol_fee_mint

string

Mint of the fee token (equals input_mint).

realized_spread_quote_raw

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.

realized_spread_bps

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.

protocol_fee_split

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

recipient

string

Recipient wallet address.

ppm

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

amount_raw

number

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

next_cursor

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

has_more

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 }
  ]
}

Volume History Recent Transactions

⌘I

Overview

Pools

Stats

Recent Swaps

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response