newPairSubscribe

Subscribe to receive notifications when a new Raydium trading 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

Supported Pairs:

  • Raydium Standard AMM (CPMM)
  • Raydium Legacy AMM v4
  • PumpSwap AMM

Subscriptions are limited to 1 per connection.

Request Parameters

None

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"
}

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

  • ammAccount

    string
    The account of the amm. This is the same as the dexscreener pair address.

  • 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.

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"
    }
}