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

See Supported DEXs

Subscriptions to newPairs are limited to 1 per connection.

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.

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.