Mintflow

The most straightforward way to stream new tokens on Solana. Connect to our WebSocket endpoint and receive real-time notifications as new tokens are created on the network.

WebSocket Endpoint

ws://localhost:3000/stream/new-tokens?api_key=<YOUR_API_KEY_HERE>

Live Stream

Status: Disconnected
Waiting for new tokens...

How to Connect

const ws = new WebSocket('ws://localhost:3000/stream/new-tokens?api_key=<YOUR_API_KEY_HERE>');

ws.onopen = () => {
  console.log('Connected to Mintflow');
};

ws.onmessage = (event) => {
  const token = JSON.parse(event.data);
  console.log('New token:', token);
};

Add Filters

You can filter tokens by sending a JSON filter object when connecting to the WebSocket.

const ws = new WebSocket('ws://localhost:3000/stream/new-tokens?api_key=<YOUR_API_KEY_HERE>');

ws.onopen = () => {
  console.log('Connected to Mintflow');
  
  // Send filter object
  const filters = {
    liquidityMinUsd: 1000,      // Minimum liquidity in USD
    liquidityMaxUsd: 100000,    // Maximum liquidity in USD
    marketcapMinUsd: 5000,      // Minimum market cap in USD
    marketcapMaxUsd: 500000,    // Maximum market cap in USD
    ageMinSeconds: 0,           // Minimum age in seconds
    ageMaxSeconds: 45,          // Maximum age in seconds (45 seconds)
    addressKeyword: "pump"      // Address must contain "pump"
  };
  
  ws.send(JSON.stringify(filters));
};

ws.onmessage = (event) => {
  const token = JSON.parse(event.data);
  console.log('Filtered token:', token);
};

REST API Endpoints

Query historical tokens using our REST API. All endpoints require authentication via API key that you can get here.

GET /new-tokens

Get the latest tokens with optional filters and pagination.

Query Parameters:

size - Number of results (1-1000, default: 25)
liquidityMinUsd - Minimum liquidity
liquidityMaxUsd - Maximum liquidity
marketcapMinUsd - Minimum market cap
marketcapMaxUsd - Maximum market cap
ageMinSeconds - Minimum token age
ageMaxSeconds - Maximum token age
addressKeyword - Search in mint address

GET /new-tokens?size=50&liquidityMinUsd=1000
http://localhost:3000/new-tokens?size=50&liquidityMinUsd=1000&api_key=YOUR_API_KEY_HERE

Response:

{
  "items": [Token...],
  "size": 50
}

GET /token/:mint

Get detailed information for a specific token by mint address.

Path Parameter:

:mint - Token mint address

GET /token/So11111111111111111111111111111111111111112
http://localhost:3000/token/So11111111111111111111111111111111111111112?api_key=YOUR_API_KEY_HERE

Response:

{
  "id": "...",
  "mintAddress": "...",
  "name": "...",
  "symbol": "...",
  "liquidityUsd": 1234.56,
  "marketcapUsd": 5678.90,
  ...
}

⚠️ Usage Limits

WebSocket: Maximum 2 concurrent connections per API key
REST API: 200 requests per second per API key for endpoints
Fair Use: Please avoid abusing the service to prevent being blacklisted

Rate limits are enforced to ensure fair usage and maintain service quality for all users.

Support Mintflow

The Mintflow project aims to provide real-time token data to developers and traders. We need your support to keep the service running, improve infrastructure, and add new features.

Your donations help us cover server costs, maintain uptime, and continue providing free access to high-quality token data for the Solana ecosystem.