Welcome to Flintr - Documentation

wss://api-v1.flintr.io/?token=[YOUR_API_KEY]

{
"timeSent": 1748036482000, 
"timeDetected": 1748036479000, 
"blockchainDelay": 1.695957, 
"transactionTime": 0.641921, 
"signature": "3Ko2…NuHv", 
"event": {
  "class": "token", 
  "platform": "pump.fun", 
  "type": "mint"
  }, 
"data": {
  "mint": "9A76…pump", 
  "metaData": {
    "name": "Example token", 
    "symbol": "EXT", 
    "description": "A new mint!", 
    "image": "https://example.com/example.png", 
    "twitter": "https://x.com/example", 
    "website": "https://x.com/i/communities/example", 
    "createdOn": "https://pump.fun"
    }, 
  "tokenData": {
    "mintDatetime": 1748036479000, 
    "updateAuthority": "TSLv…eokM", 
    "creator": "8U6d…as6s", 
    "decimals": 6, 
    "isBundled": true, 
    "bundleAmount": 0.9903592,
    "latestPrice": "0.000000029822"
    }, 
  "ammData": {
    "bondingCurve": "F21P…oSvK", 
    "associatedBondingCurve": "EBDk…X3p3", 
    "vaultCreatorATA": "GMVf…771s", 
    "vaultCreatorAuthority": "f2Z4…tVA9"
    }
  }
}

{
"timeSent": 1746387580000, 
"timeDetected": 1746387578000, 
"blockchainDelay": 1.588838, 
"transactionTime": 0.716285, 
"signature": "498b…fhhS", 
"event": {
  "class": "token", 
  "platform": "pump.fun", 
  "type": "graduation"
  }, 
"data": {
  "mint": "Skb3…pump",
  "metaData": {
    "name": "Example token", 
    "symbol": "EXT", 
    "description": "A graduation meme token", 
    "image": "https://example.com/example.png", 
    "twitter": "https://x.com/example", 
    "website": "https://x.com/i/communities/example"
    }, 
  "tokenData": {
    "mintDatetime": 1746386003463, 
    "migrateInstruction": true, 
    "lockedLP": true, 
    "freezeAuthority": null, 
    "mintAuthority": null,
    "updateAuthority": "3zDg…VNaA", 
    "isNative": false, 
    "holderDistribution": {
      "0": {"address": "DXYZ…wzFbD", "amount": 212943394.916821}, 
      "1": {"address": "8S43…JwJw", "amount": 30905022.792736}, 
      "2": {"address": "81Yf…fQf5", "amount": 30027308.835351}, 
      "3": {"address": "FPjM…kHwu", "amount": 27029480.942816}, 
      "4": {"address": "8UiW…qWCP", "amount": 17044849.192236}, 
      "5": {"address": "Fc1j…hC4z", "amount": 15582914.502887}, 
      "6": {"address": "Fa31…HtnW", "amount": 15295954.591196}, 
      "7": {"address": "HTxG…dxPQ", "amount": 14566477.861491}, 
      "8": {"address": "HWka…DMVi", "amount": 14509102.054108}, 
      "9": {"address": "EHqP…ERAx", "amount": 14337490.68874}
      }, 
    "creator": "2xKD…pFFQ",
    "signer": "39az…UJjg",
    "quoteAmount": "84.990359973", 
    "baseAmount": "206900000", 
    "decimals": 6
    }, 
  "ammData": {
    "ammId": "CbuM…yoE6", 
    "poolBase": "DXYZ…zFbD", 
    "poolQuote": "Ec7c…iexh",
    "vaultCreatorATA": "9zmj…PWU1Z", 
    "vaultCreatorAuthority": "9BpU…opX9D"
    }, 
  "platformData": {
    "marketCapInSOL": 400.320762125, 
    "pumpKOTHDatetime": 1746386505000,
    "pumpTrades": 1939, 
    "pumpLikes": 17, 
    "pumpReplies": 13
    }
  }
}

{
"time": "2025-05-04 20:31:08", 
"event": {
  "class": "ping"
  }
}

// API key from your Flintr dashboard
const API_KEY = 'YOUR_API_KEY';
const WS_URL  = `wss://api-v1.flintr.io/sub?token=${API_KEY}`;

// Connect to Flintr WebSocket API
function connect() {
  const ws = new WebSocket(WS_URL);

  ws.onopen = () => console.log('✅ Connected');
  ws.onmessage = e => {
    try {
      const sig = JSON.parse(e.data);
      console.log('🔔 Signal:', sig);
      // …your buy logic here…

    } catch {
      console.error('⚠️ Invalid JSON:', e.data);
    }
  };
  ws.onerror = e => console.error('⚠️ Error', e);
  ws.onclose = () => {
    console.log('🔴 Disconnected — reconnecting in 5s');
    setTimeout(connect, 5000);
  };
}

// kick things off
connect();

import json
import time
from websocket import WebSocketApp

# API key from your Flintr dashboard
API_KEY = "YOUR_API_KEY"

WS_URL = f"wss://api-v1.flintr.io/sub?token={API_KEY}"

def on_open(ws: WebSocketApp):
    print("[Flintr] Connected → streaming signals…")

def on_message(ws: WebSocketApp, message: str):
    try:
        sig = json.loads(message)
    except json.JSONDecodeError:
        print("⚠️  Malformed JSON:", message)
        return

    # pretty-print the entire signal
    print(json.dumps(sig, indent=2))

    # …your buy logic here…

def on_error(ws: WebSocketApp, error):
    print(f"Error: {error}")

def on_close(ws: WebSocketApp, close_status_code, close_msg):
    print(f"Disconnected (code={close_status_code}): {close_msg}")
    # auto-reconnect after a pause
    time.sleep(5)
    print("Reconnecting…")
    start_ws()

def start_ws():
    ws = WebSocketApp(
        WS_URL,
        on_open=on_open,
        on_message=on_message,
        on_error=on_error,
        on_close=on_close
    )

    # run in blocking mode with ping keep-alive
    ws.run_forever(ping_interval=30, ping_timeout=10)

if __name__ == '__main__':
    try:
        start_ws()
    except KeyboardInterrupt:
        print("\nStopped by user")