Documentation

Get the tip floor

Read an edge's observed landed-tip percentiles as a JSON array, without a JSON-RPC envelope.

// updated 2026-11-17

NOTE

Supanode issues keys through Telegram. Default minimum tip: 0.001 SOL; default rate: 15 sends/s per key per metro. Your key settings can differ. Declared tips are off by default and require enablement and a payment arrangement with Supanode. If your key returns partner_declared_tips, use an on-chain transfer instead.

GET https://fra.tpu.supanode.xyz/tip_floor

Authentication: API key, one of: x-api-key header, api-key query, Authorization: Bearer header.

Responses

200

Returns an array of zero or one observed tip-floor snapshots as an application/json array, without a JSON-RPC envelope. An empty array means no recent landing data is available.

Content type: application/json

Zero or one tip floor snapshot; an empty array means no recent landing data is available. The snapshot describes tips that already landed and does not predict landing; your key's minimum tip still applies. Each metro reports its own values; use a named metro hostname to compare them.

FieldTypeRequiredDescription
[].timestring (date-time)yesWhen the snapshot was computed, RFC 3339 in UTC, to the second.
[].landed_tips_25th_percentileintegeryesThe edge's 25th landed-tip percentile, in lamports. minimum: 0.
[].landed_tips_50th_percentileintegeryesThe edge's 50th landed-tip percentile, in lamports. minimum: 0.
[].landed_tips_75th_percentileintegeryesThe edge's 75th landed-tip percentile, in lamports. minimum: 0.
[].landed_tips_95th_percentileintegeryesThe edge's 95th landed-tip percentile, in lamports. minimum: 0.
[].landed_tips_99th_percentileintegeryesThe edge's 99th landed-tip percentile, in lamports. minimum: 0.
[]

401

unauthorized: missing, unknown or revoked API key.

Content type: application/json

Reason-specific fields are included alongside these members, such as minimum, found, declared, available, unpaid_lamports, index, per_second and retry_after_ms. Failed preflight also includes Solana simulation fields such as err, logs and unitsConsumed.

FieldTypeRequiredDescription
reasonstringyesStable snake_case reason. Match on this; message wording can change, and the numeric codes are shared with Solana's RPC.
messagestringyesWhat happened and what to change. Wording can change.
retryablebooleanyesWhether the unchanged request can succeed later. Wait before retrying, and check that the transaction has not expired.
docsstring (uri)noOptional error documentation URL followed by the reason anchor. Supanode endpoints omit this field.
{
  "reason": "unauthorized",
  "message": "API key missing or not recognized; pass it as the api-key query parameter, an x-api-key header or Authorization: Bearer",
  "retryable": false
}

421

Unknown or removed TLS SNI or HTTP Host/:authority. Returns plain text without a JSON-RPC envelope or rejection object. The current hostname policy also applies to existing connections and resumed TLS sessions.

Content type: text/plain

This hostname is not served here. Check the endpoint address

Code samples

// src/bin/http_tip_floor.rs
// Builds on the example project (/reference/json-rpc#example-project).
use serde::Deserialize;
use swqos_examples::swqos::{Result, required, url};

#[derive(Deserialize)]
struct TipFloor {
    time: String,
    landed_tips_50th_percentile: u64,
}

#[tokio::main]
async fn main() -> Result<()> {
    let mut endpoint = reqwest::Url::parse(&url())?;
    endpoint.set_path("/tip_floor");
    endpoint.set_query(None);
    let response = reqwest::Client::new().get(endpoint)
        .header("x-api-key", required("SWQOS_API_KEY")?)
        .send().await?;
    let status = response.status();
    let body = response.text().await?;
    if !status.is_success() {
        return Err(format!("HTTP {status}: {body}").into());
    }
    let floors: Vec<TipFloor> = serde_json::from_str(&body)?;
    if let Some(floor) = floors.first() {
        println!("{}: median landed tip {} lamports", floor.time, floor.landed_tips_50th_percentile);
    } else {
        println!("no recent landing data");
    }
    Ok(())
}
// http_tip_floor/main.go
package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "net/url"
    "os"

    swqos "swqos-examples"
)

type TipFloor struct {
    Time string `json:"time"`
    Percentile50 uint64 `json:"landed_tips_50th_percentile"`
}

func run() error {
    apiKey, err := swqos.Required("SWQOS_API_KEY")
    if err != nil {
        return err
    }
    endpoint, err := url.Parse(swqos.URL())
    if err != nil {
        return err
    }
    endpoint.Path = "/tip_floor"
    endpoint.RawQuery = ""
    request, err := http.NewRequest(http.MethodGet, endpoint.String(), nil)
    if err != nil {
        return err
    }
    request.Header.Set("x-api-key", apiKey)
    response, err := http.DefaultClient.Do(request)
    if err != nil {
        return err
    }
    defer response.Body.Close()
    body, err := io.ReadAll(response.Body)
    if err != nil {
        return err
    }
    if response.StatusCode < 200 || response.StatusCode >= 300 {
        return fmt.Errorf("HTTP %d: %s", response.StatusCode, body)
    }
    var floors []TipFloor
    if err := json.Unmarshal(body, &floors); err != nil {
        return err
    }
    if len(floors) == 0 {
        fmt.Println("no recent landing data")
    } else {
        fmt.Printf("%s: median landed tip %d lamports\n", floors[0].Time, floors[0].Percentile50)
    }
    return nil
}

func main() {
    if err := run(); err != nil {
        fmt.Fprintln(os.Stderr, err)
        os.Exit(1)
    }
}
// http-tip-floor.ts
import { required, url } from './swqos.ts'

type TipFloor = { time: string; landed_tips_50th_percentile: number }

const endpoint = new URL('/tip_floor', url)
const response = await fetch(endpoint, { headers: { 'x-api-key': required('SWQOS_API_KEY') } })
const body = await response.text()
if (!response.ok) throw new Error(`HTTP ${response.status}: ${body}`)
const [floor] = JSON.parse(body) as TipFloor[]
if (floor) console.log(`${floor.time}: median landed tip ${floor.landed_tips_50th_percentile} lamports`)
else console.log('no recent landing data')