Documentation

Pool Protocol Docs

Solana token market making made simple. Register your token, fund the wallet, and let the bot handle the rest.

Beta - Pump.fun AMM Only

Pool Protocol is currently in beta and only supports tokens that have migrated to Pump.fun AMM. Support for other launchpads and bonding curves will be activated soon.

Overview

Automated Market Making

Pool Protocol automatically executes buy and sell orders for your token, maintaining healthy trading activity.

Dedicated Wallets

Each token gets its own market maker wallet. Simply fund it with SOL and tokens to start trading.

Real-time Updates

Track all transactions in real-time via WebSocket connections. See buys and sells as they happen.

REST API

Full REST API access to manage tokens, view transactions, and integrate with your applications.

Getting Started

Register Your Token

Go to the Register page and enter your token's mint address. We'll automatically fetch the metadata from the blockchain.

Fund the Market Maker Wallet

Each token gets a dedicated wallet. Send SOL (for buys) and your tokens (for sells) to the MM wallet address shown on your token page.

Watch the Magic

Once funded and activated, the bot will automatically execute trades. Track all activity in real-time on your token's page.

API Reference

Base URL: https://api.p00l.io

Health

Tokens

Transactions

WebSocket

Real-time trade updates

Connect to the WebSocket server to receive real-time trade notifications.

Connection URL

wss://ws-mainnet.p00l.io

Welcome Message

Upon connection, you'll receive a welcome message with server status:

{
  "type": "WELCOME",
  "data": {
    "workers": 5,
    "clients": 142,
    "db": true
  }
}

Trade Message Format

When a trade occurs, you'll receive:

{
  "type": "TRADE",
  "data": {
    "action": "BUY",
    "solAmount": 0.5,
    "tokenAmount": 1000000,
    "signature": "5xK2j...",
    "mint": "ABC123...",
    "symbol": "MTK",
    "formatted": "0.5 SOL buy $MTK"
  }
}

Trade Data Fields

action"BUY" or "SELL"

solAmountAmount of SOL (for buys)

tokenAmountAmount of tokens (for sells)

signatureSolana transaction signature

mintToken mint address

symbolToken symbol (e.g., "MTK")

formattedHuman-readable trade summary

Example (JavaScript)

const ws = new WebSocket("wss://ws-mainnet.p00l.io");

ws.onopen = () => {
  console.log("Connected to Pool Protocol WebSocket");
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);

  if (msg.type === "WELCOME") {
    console.log("Server status:", msg.data);
  }

  if (msg.type === "TRADE") {
    const { action, solAmount, tokenAmount, symbol, signature } = msg.data;

    if (action === "BUY") {
      console.log(`🟢 Buy: ${solAmount} SOL → $${symbol}`);
    } else {
      console.log(`🔴 Sell: ${tokenAmount} $${symbol}`);
    }
  }
};

ws.onclose = () => {
  console.log("Disconnected, reconnecting...");
  setTimeout(() => connect(), 3000);
};

Note: Clients are read-only and cannot send messages. The WebSocket connection will automatically reconnect if disconnected.

Status Codes

Code	Description
`200`	Success
`201`	Created (new token registered)
`400`	Bad request (invalid input)
`404`	Not found
`500`	Internal server error