1 of 27

Docs | monitor.ws

Welcome

Welcome to the Monitor.ws documentation. This guide is designed to assist you in integrating our service into your project.

Monitor.ws enables you to access real-time on-chain and off-chain data through a WebSocket connection. In the near future, we will also introduce several endpoints to provide access to historical data.

All our responses are JSON formated and ready for immediate use. If you have ideas for additional features to include, please feel free to let us know via our Telegram.

Jump right in

Supported pools

Pumpfun
Pumpfun AMM
Raydium AMM V4
Raydium CPMM
Meteora DLMM
Lifinity
Obric
SolFI
... (coming soon)

Beta

We are currently in the beta phase, actively developing our service.

As such, access is provided to you entirely free of charge, at no cost to you. If any issue arises during use, please report it to us as soon as possible; our team will give it the utmost attention.

The goal of this beta is to address all issues, meet your expectations, and enhance our service.

The beta is available for everyone, no API key is required at the moment. Being in our Telegram would help us a lot in taking your feedback into account.

Websocket

Quickstart

The Monitor WebSocket enables you to stream both on-chain and off-chain data. On-chain data (trade, creation, migration) are pre-parsed, ready for immediate use, and accessible through a variety of available endpoints.

If you have suggestions for new endpoints, feel free to reach out to our development team via our Telegram chat. Thank you for your contributions to the project!

We are currently in BETA. WebSocket access is free in exchange of your feedback.

Connection

No API key is required to use our WebSocket connection. It is free to use, and we do not have any hidden costs.

Once you are connected, you can explore our On/Off-Chain Data section to send messages to our server. You can also establish a connection by sending a message directly.

To maintain a stable connection, it's important to send a ping request every 8 minutes. The server allows a maximum duration of 10 minutes without a ping request from the client. This can be easily managed by using a keep-alive function when opening the WebSocket connection.

During the BETA phase, there is no limit on connections.

wss://api.monitor.ws/connect

COMMING SOON

COMMING SOON

COMMING SOON

Dev Support

If you encounter any difficulties integrating the WebSocket connection into your script, our development team is here to assist. Feel free to join our Telegram community, where you can ask questions, and receive support directly from the team and other developers.

On-Chain Data

All

Our All Monitoring features enable you to track every event that includes your filter on Solana in real time.

For details on the supported event types, please refer to the event list available in the On-Chain data section.

Payload

Add one or more public keys to monitor by replacing pbk_n with the desired Solana public keys.

Remove one or more public keys from monitoring by replacing pbk_n with the desired Solana public keys.

Response

To know the possible structure of the returned event, please refer to the event list available in the On-Chain data section.

Filters available in the trade response

Filters available in the creation response

Filters available in the migration response

Filters available in the transfer response

Account

Our Account Trade Monitoring features enable you to track Trades executed by a specific Solana public key in real time.

For details on the supported pool types, please refer to the Welcome section of our documentation.

Payload

Add one or more account to monitor by replacing pbk_n with the desired Solana account public keys.

{
   "event": "listenAccountTrade",
   "content": [
      "pbk_one",
      "pbk_two",
      "..."
   ]
}

Remove one or more accounts from monitoring by replacing pbk_n with the desired Solana account public keys.

{
   "event": "removeAccountTrade",
   "content": [
      "pbk_one",
      "pbk_two",
      "..."
   ]
}

Response

The pool.type response may vary depending on the pool used to purchase/sell the token. The isBuy field will only be available if one of the input/output tokens is equal to solMint.

marketcap, marketcap_usd, and bonding_percentage are omitempty.

{
   "signature":"solana.Signature",
   "signer":[
      "solana.PublicKey",
      "..."
   ],
   "trade":{
      "user":"solana.PublicKey",
      "mint_in":"solana.PublicKey",
      "token_in": float64,
      "decimals_in":int,
      "mint_out":"solana.PublicKey",
      "token_out":float64,
      "decimals_out":int,
      "isBuy":bool
   },
   "pool":{
      "type":"string",
      "pairs":[
         {
            "mint":"solana.PublicKey",
            "amount":float64,
            "decimals":int
         },
         {
            "mint":"solana.PublicKey",
            "amount":float64,
            "decimals":int
         }
      ],
      "marketcap":float64,
      "marketcap_usd":float64,
      "bonding_percentage":float64
   },
   "details": {
      "slot": uint64,
      "block_height": uint64,
      "timestamp": int64
  }
}

Signer

Our Signer Trade Monitoring features enable you to track Trades signed by a specific Solana public key in real time.

For details on the supported pool types, please refer to the Welcome section of our documentation.

Payload

Add one or more signers to monitor by replacing pbk_n with the desired Solana signer public keys.

{
   "event": "listenSignerTrade",
   "content": [
      "pbk_one",
      "pbk_two",
      "..."
   ]
}

Remove one or more signers from monitoring by replacing pbk_n with the desired Solana signer public keys.

{
   "event": "removeSignerTrade",
   "content": [
      "pbk_one",
      "pbk_two",
      "..."
   ]
}

Response

The pool.type response may vary depending on the pool used to purchase/sell the token. The isBuy field will only be available if one of the input/output tokens is equal to solMint.

marketcap, marketcap_usd, and bonding_percentage are omitempty.

{
   "signature":"solana.Signature",
   "signer":[
      "solana.PublicKey",
      "..."
   ],
   "trade":{
      "user":"solana.PublicKey",
      "mint_in":"solana.PublicKey",
      "token_in": float64,
      "decimals_in":int,
      "mint_out":"solana.PublicKey",
      "token_out":float64,
      "decimals_out":int,
      "isBuy":bool
   },
   "pool":{
      "type":"string",
      "pairs":[
         {
            "mint":"solana.PublicKey",
            "amount":float64,
            "decimals":int
         },
         {
            "mint":"solana.PublicKey",
            "amount":float64,
            "decimals":int
         }
      ],
      "marketcap":float64,
      "marketcap_usd":float64,
      "bonding_percentage":float64
   },
   "details": {
      "slot": uint64,
      "block_height": uint64,
      "timestamp": int64
  }
}

Token

Our Token Trade Monitoring features enable you to track Trades made on a specific Solana token in real time.

For details on the supported pool types, please refer to the Welcome section of our documentation.

Payload

Add one or more tokens to monitor by replacing pbk_n with the desired Solana token public keys (mint).

Remove one or more tokens from monitoring by replacing pbk_n with the desired Solana token public keys (mint).

Response

The pool.type response may vary depending on the pool used to purchase/sell the token. The isBuy field will only be available if one of the input/output tokens is equal to solMint.

marketcap, marketcap_usd, and bonding_percentage are omitempty.

Creation

Our Token Creation Monitoring features enable you to track new Tokens created on Solana in real time.

Only Pumpfun token creation is supported at the moment.

Payload

You can use multiple token creation parameters simultaneously.

All token creation events: content field is empty ("")
Signer
Public Key (mint)
User (creator account)
Name
Symbol

Add one or more token creation events to monitor by replacing value_n with the desired token creation parameters.

{
   "event": "listenTokenCreation",
   "content": [
      "value_one",
      "value_two",
      "..."
   ]
}

Remove one or more token creation events from monitoring by replacing value_n with the desired token creation parameters.

{
   "event": "removeTokenCreation",
   "content": [
      "value_one",
      "value_two",
      "..."
   ]
}

Response

Every data field in the struct below will always be available for Pumpfun creation. The Trade field can be empty if there is no dev buy.

{
   "signature":"solana.Signature",
   "signer":[
      "solana.PublicKey",
      "..."
   ],
   "trade":{
      "user":"solana.PublicKey",
      "mint_in":"solana.PublicKey",
      "token_in": float64,
      "decimals_in":int,
      "mint_out":"solana.PublicKey",
      "token_out":float64,
      "decimals_out":int,
      "isBuy":bool
   },
   "create": {
      "user": "solana.PublicKey",
      "mint": "solana.PublicKey",
      "bonding_curve": "solana.PublicKey",
      "name": "string",
      "symbol": "string",
      "uri": "string"
  },
   "pool":{
      "type":"string",
      "pairs":[
         {
            "mint":"solana.PublicKey",
            "amount":float64,
            "decimals":int
         },
         {
            "mint":"solana.PublicKey",
            "amount":float64,
            "decimals":int
         }
      ],
      "marketcap":float64,
      "marketcap_usd":float64,
      "bonding_percentage":float64
   },
   "details": {
      "slot": uint64,
      "block_height": uint64,
      "timestamp": int64
  }
}

Migration

Our Token Migrations Monitoring features enable you to track token Migration on Pump.fun in real time.

Since 20/03/2025, the Pumpfun migration has been made to the new Pumpfun AMM program.

Payload

You can use multiple token migration parameters simultaneously.

All token migration events: content field is empty ("")

Add one or more token migration events to monitor by replacing value_n with the desired token migration parameters.

{
   "event": "listenTokenMigration",
   "content": [
      "value_one",
      "value_two",
      "..."
   ]
}

Remove one or more token migration events from monitoring by replacing value_n with the desired token migration parameters.

{
   "event": "removeTokenMigration",
   "content": [
      "value_one",
      "value_two",
      "..."
   ]
}

Response

If you need more information, feel free to contact us on our Telegram.

{
   "signature":"solana.Signature",
   "signer":[
      "solana.PublicKey",
      "..."
   ],
   "migrate":{
      "mint":"solana.PublicKey",
      "amm":"solana.PublicKey"
   },
   "pool":{
      "type":"string",
      "pairs":[
         {
            "mint":"solana.PublicKey",
            "amount":float64,
            "decimals":"int"
         },
         {
            "mint":"solana.PublicKey",
            "amount":float64,
            "decimals":"int"
         }
      ],
      "marketcap":float64,
      "marketcap_usd":float64
   },
   "details":{
      "slot":uint64,
      "block_height":uint64,
      "timestamp":int64
   }
}

Transfer

Our Transfer Monitoring features enable you to track SOL/SPL Transfer made on Sonala in real time.

Transfer and TransferChecked type are supported.

Payload

You can use multiple transfer parameters simultaneously.

Signer
Mint
Sender
Recipient

Add one or more transfer events to monitor by replacing value_n with the desired transfer parameters.

{
   "event": "listenTransfer",
   "content": [
      "value_one",
      "value_two",
      "..."
   ]
}

Remove one or more transfer events from monitoring by replacing value_n with the desired transfer parameters.

{
   "event": "removeTransfer",
   "content": [
      "value_one",
      "value_two",
      "..."
   ]
}

Response

{
    "signature": "solana.Signature",
    "signer":[
        "solana.PublicKey",
        "..."
     ],
    "transfer": {
        "mint": "solana.PublicKey",
        "sender": "solana.PublicKey",
        "recipient": "solana.PublicKey",
        "amount": float64,
        "token_decimals": int
    },
    "details": {
        "slot": uint64,
        "block_height": uint64,
        "timestamp": int64
    }
}

Off-Chain Data

Coming soon

Pumpfun Monitor

Coming soon...

King of the Hill

Our King of the Hill Monitoring features enable you to track the current King Of The Hill token on the Pump.fun website.

This event may be unavailable if the Pump.fun website is updated. Please contact us on if that is the case.

Payload

Currently, no filters are available for this event. If you need them, please with the necessary filters.

Response

The market_cap and usd_market_cap fields may not reflect the exact values when you receive the event. These values may have a small delay of up to 1 second.

Dexscreener Monitor

Dex Paid

Our Dex Paid Monitoring features enable you to track new Dex Paid token on the Dexscreener website.

This event may be unavailable if the Dexscreener website is updated. Please contact us on if that is the case.

Payload

Currently, no filters are available for this event. If you need them, please with the necessary filters.

Response

The metrics fields may not reflect the exact values when you receive the event. These values may have a small delay.

Dex Boost

Our Dex Boost Monitoring features enable you to track boosts applied to a token on the Dexscreener website.

This event may be unavailable if the Dexscreener website is updated. Please contact us on Telegram if that is the case.

Payload

Currently, no filters are available for this event. If you need them, please contact us with the necessary filters.

{
   "event": "listenDexBoost"
}

{
   "event": "removeDexBoost"
}

Response

The metrics fields may not reflect the exact values when you receive the event. These values may have a small delay. The boost.amount field represents the number of boosts applied for the event.

{
    "mint": "solana.PublicKey",
    "keys": {
        "pair": "solana.PublicKey",
        "quote": "solana.PublicKey"
    },
    "infos": {
        "name": "string",
        "symbol": "string",
        "type": "string",
        "created": "int"
    },
    "metrics": {
        "market_cap": "float64",
        "fdv": "float64",
        "volume": {
            "h1": float64,
            "h24": float64,
            "h6": float64,
            "m5": float64
        },
        "price_change": {
            "h1": float64,
            "h24": float64,
            "h6": float64,
            "m5": float64
        },
        "txns": {
            "h1": {
                "buys": int,
                "sells": int
            },
            "h24": {
                "buys": int,
                "sells": int
            },
            "h6": {
                "buys": int,
                "sells": int
            },
            "m5": {
                "buys": int,
                "sells": int
            }
        },
        "liquidity": {
            "usd": float64,
            "base": float64,
            "quote": float64
        },
        "price": {
            "sol": float64,
            "usd": float64
        }
    },
    "links": {
        "url": "string",
        "image": "string",
        "header": "string",
        "opengraph": "string",
        "websites": [
            {
                "label": "string",
                "url": "string"
            }
        ],
        "socials": [
            {
                "type": "string",
                "url": "string"
            }
        ]
    },
    "boosts": {
        "total": "int",
        "amount": "int"
    }
}

Api

Quickstart

The Monitor Api enables you to get both on-chain and off-chain data. On-chain data are pre-parsed, ready for immediate use, and accessible through a variety of available endpoints.

If you have suggestions for new endpoints, feel free to reach out to our development team via our Telegram chat. Thank you for your contributions to the project!

We are currently in BETA. Api access is free in exchange for your feedback.

Connexion

No API key is required to use our WebSocket connection. It is free to use, and we do not have any hidden costs.

During the BETA phase, there is no limit on RPS.

Dev Support

If you encounter any difficulties integrating the Api into your script, our development team is here to assist. Feel free to join our Telegram community, where you can ask questions, and receive support directly from the team and other developers.

Transaction

Trade

Our Trade API endpoint allows you to execute trades with a single request.

We handle the creation of the transaction as well as sending it through multiple endpoints to ensure the fastest possible landing.

Our Trade endpoint is currently in BETA. The trade fee is 0.1% of your equivalent SOL trade amount.

Endpoint

Since we are in BETA, this endpoint may change at any time.

Payload

Your private key is not stored or logged. We will soon upgrade to an API key system.

mev_protection, skip_preflight, custom_tip_address, custom_tip_percentage are optional parameters. You don't need to add them to the payload.

The response timeout is set to 15 seconds. After this time, an error will be returned.

Success message returned

Error returned

On-Chain Data

Token

Metadata

Our Token Metadata API endpoint allows you to retrieve the parsed metadata of a token.

In order to provide complete information, this endpoint will perform an off-chain request to obtain the description as well as the logo and socials.

Endpoint

Since we are in BETA, this endpoint may change at any time.

GET

https://api.monitor.ws/api/token/metadata

Payload

Add one or more token by replacing pbk_n with the desired Solana account public keys (mint).

[
    "pbk_one",
    "pbk_two",
    "..."
]

Response

Token metadata are cached on our server. This means that your next request with the same token mint will be faster.

[
    {
      "mint": "solana.PublicKey",
      "name": "string",
      "symbol": "string",
      "description": "string",
      "links": {
        "image": "string",
        "twitter": "string",
        "telegram": "string",
        "website": "string"
      }
    },
    {
      "mint": "solana.PublicKey",
      "name": "string",
      "symbol": "string",
      "description": "string",
      "links": {
        "image": "string",
        "twitter": "string",
        "telegram": "string",
        "website": "string"
      }
    },
    {
      "mint": "solana.PublicKey",
      "name": "string",
      "symbol": "string",
      "description": "string",
      "links": {
        "image": "string",
        "twitter": "string",
        "telegram": "string",
        "website": "string"
      }
    }
]

Info

Our Token Info API endpoint allows you to retrieve the parsed metadata of a token and off-chain metadata.

In order to provide complete information, this endpoint will perform an off-chain request to obtain the description as well as the logo and similar information.

Endpoint

Since we are in BETA, this endpoint may change at any time.

GET

https://api.monitor.ws/api/token/info

Payload

Add one or more token by replacing pbk_n with the desired Solana account public keys (mint).

[
    "pbk_one",
    "pbk_two",
    "..."
]

Response

Token metadata are cached on our server. This means that your next request with the same token mint will be faster.

[
    {
        "Metadata": {
          "mint": "solana.PublicKey",
          "name": "string",
          "symbol": "string",
          "description": "string",
          "links": {
            "image": "string",
            "twitter": "string",
            "telegram": "string",
            "website": "string"
          }
        },
    
        "Dex": {
          "IsPaid": false,
          "Info": {
            "mint": "solana.PublicKey",
            "keys": {
              "pair": "solana.PublicKey",
              "quote": "solana.PublicKey"
            },
            "infos": {
              "name": "string",
              "symbol": "string",
              "type": "string",
              "created": "int"
            },
            "metrics": {
              "market_cap": "float64",
              "fdv": "float64",
              "volume": {
                "h1": "float64",
                "h24": "float64",
                "h6": "float64",
                "m5": "float64"
              },
              "price_change": {
                "h1": "float64",
                "h24": "float64",
                "h6": "float64",
                "m5": "float64"
              },
              "txns": {
                "h1": {
                  "buys": "int",
                  "sells": "int"
                },
                "h24": {
                  "buys": "int",
                  "sells": "int"
                },
                "h6": {
                  "buys": "int",
                  "sells": "int"
                },
                "m5": {
                  "buys": "int",
                  "sells": "int"
                }
              },
              "liquidity": {
                "usd": "float64",
                "base": "float64",
                "quote": "float64"
              },
              "price": {
                "sol": "float64",
                "usd": "float64"
              }
            },
            "links": {
              "url": "string",
              "image": "string",
              "header": "string",
              "opengraph": "string",
              "websites": [
                {
                  "label": "string",
                  "url": "string"
                }
              ],
              "socials": [
                {
                  "type": "string",
                  "url": "string"
                }
              ]
            },
            "boosts": {
              "total": "int"
            }
          }
        }
    },
    ...
]