Welcome
🏰  What is SolanaStreaming?
Websocket API
🌎  Overview 🔑  Connecting ❌  Errors ❓  FAQ ❤️  Health

newPairSubscribe

Subscribe to receive notifications when a new token pair is created with wSol.

Notifications may arrive out of order. E.g. If multiple pairs are created in a block, the first pair created isn't guarenteed to be returned first in the subscription.

It is strongly suggested you use the blockTime to calculate the notification latency to ensure the data is the most recent available.

It uses commitment level confirmed which allows for a fast response time with reasonable confidence on being included in the blockchain. See more about commitment levels here

Known Issue
For most pairs / launch tokens, if the pair contains wSOL, it will force this to be the quote token (which it usually is anyway). For some pairs, this means the quote and base will be swapped. We are working to address the best possible way forward as the chain does not always report which token is the base/quote.

See Supported DEXs

Subscriptions to newPairs are limited to 1 per connection.

Try it out in the Console

Request Parameters

  • include_pumpfun

    boolean
    Set to true to include new pumpfun pairs. false by default

Response Fields

  • subscription_id

    unsigned integer
    The subscription id which can be used to unsubscribe and associate websocket messages with the subscription.

Request Example

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "newPairSubscribe",
    "params": {
        "include_pumpfun": true
    }
}

Response Example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "subscription_id": 1
    }
}

newPairNotification

These are the notifications you will receive when newPairSubscribe is called successfully. Notifications do not typically conform to jsonrpc.

Notification Fields

  • subscription_id

    unsigned integer
    The subscription id which was returned when creating the subscription. This can be used to unsubscribe with the newPairUnsubscribe method.

  • method

    string
    The name of the notification.

  • params

    newPairObject

newPairObject

  • slot

    unsigned integer
    The slot of the transaction that created the new pair.

  • signature

    string
    The signature of the transaction that created the new pair.

  • blockTime

    unsigned integer
    The time the block was confirmed in the unix seconds timestamp format. This will match the blocktime in solscan.

  • pair

    pairObject

pairObject

  • sourceExchange

    string
    The name of the exchange the pair is located.
    Supported values: raydium, pumpswap, pumpfun

  • ammAccount

    string
    The account of the amm. This is the same as the dexscreener pair address. For Pumpfun tokens, this is the bondingCurve account.

  • baseToken

    tokenObject

  • quoteToken

    tokenObject
    The quote token is usually wrapped sol (wSol).

  • baseTokenLiquidityAdded

    string
    The amount of base token liquidity added to the pool upon creation. This is a bigint but formatted as a string for json compatibility. It is the raw amount.

  • quoteTokenLiquidityAdded

    string
    The amount of quote token liquidity added to the pool upon creation. This is a bigint but formatted as a string for json compatibility. It is the raw amount. The quote token is usually wrapped sol (wSol). E.g. a value of "12000000000" raw wSol with 9 decimals would format to be 12 wSol.

  • migration

    string | null
    The name of the exchange the pair was migrated from. (This only happens once per token)
    Supported values: pumpfun

tokenObject

  • account

    string
    The base58 address as a string for the token.

  • info

    tokenInfoObject | null
    Contains extra information about the token. Null if could not be retrieved.

tokenInfoObject

  • decimals

    unsigned integer
    The number of decimals for this token.

  • supply

    string
    The raw amount of supply for this token formatted as a string.

  • metadata

    tokenMetadataObject | null
    Contains token metadata which is stored at a different chain address. Null if the data is not available.

  • mintAuthority

    string | null
    The base58 address of the mint authority if this token has one. Null if the token doesnt have a mint authority.

  • freezeAuthority

    string | null
    The base58 address of the freeze authority if this token has one. Null if the token doesnt have a freeze authority.

tokenMetadataObject

  • name

    string
    The name of the token.

  • symbol

    string
    The symbol of the token.

  • logo

    string | null
    The url of the logo for the token. This is a third party url so the image could take any format. Only visit external links like these with caution. Null if no logo is available.

Notification Example

{
    "slot": 301578636,
    "signature": "UWnvRXCHpmDxb9tQAYYEEoY8r2JVZ3CcbDLpsFp8EGBdv5njjyEkGXhYxcFCc7Y68X15SWrfve4rycvM4vGRJh7",
    "blockTime": 1731688226,
    "pair": {
        "sourceExchange": "raydium",
        "ammAccount": "CDnqCfvxQvncrWpoTT36xBCcthzQyh8RumuvoFsFZNVC",
        "baseToken": {
            "account": "G9GZaVRPiYRfNQF7oqNoeXKwB5jFbLSHe5fxLcCpump",
            "info": {
                "decimals": 9,
                "supply": "206900000000000000",
                "metadata": {
                    "name": "randomcoin",
                    "symbol": "randomcoin",
                    "logo": "https://arweave.net/xDf9sPlSY4SMmFQzyCK-xakNl-m7a17lKPO6BttSO3M"
                },
                "mintAuthority": null,
                "freezeAuthority": null
            }
        },
        "quoteToken": {
            "account": "So11111111111111111111111111111111111111112",
            "info": null
        },
        "baseTokenLiquidityAdded": "206900000000000000",
        "quoteTokenLiquidityAdded": "630000000000"
    }
}