WebSocket

curl --request GET \
  --url https://api.raze.bot/v1/ws \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.raze.bot/v1/ws', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.raze.bot/v1/ws",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.raze.bot/v1/ws"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.raze.bot/v1/ws")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "error": {
    "code": "unauthorized",
    "message": "missing or unknown API key (send it as x-api-key)"
  }
}

{
  "error": {
    "code": "server_busy",
    "message": "the server is at capacity, retry in 30 s"
  }
}

Reference

WebSocket

Upgrade to a WebSocket that carries any number of live channels (up to 200 per socket). Send JSON ops, receive JSON frames:

→ {"op":"subscribe","id":"t1","channel":"trades","chain":"sol","token":"<mint>"}
← {"type":"subscribed","id":"t1","channel":"trades"}
← {"id":"t1","channel":"trades","chain":"sol","token":"<mint>","type":"snapshot","data":[Trade…]}
← {"id":"t1","channel":"trades","chain":"sol","token":"<mint>","type":"trade","data":Trade}
→ {"op":"unsubscribe","id":"t1"}
→ {"op":"ping"}   ← {"type":"pong"}

Query parameters of the upgrade URL (?channel=trades&chain=sol&token=…) subscribe one channel right away. Channels and frames: see the Streaming guide. While the server is at capacity, a new socket’s upgrade answers 503 (server_busy, Retry-After: 30); open sockets keep running. The same socket is at wss://ws.raze.bot (the bare path is /v1/ws).

A Solana block that loses its fork. Its trades may already have gone out live, and they never happened there. On Solana the trades channel can then send one retract frame per lost slot, after the trades it names, usually 10–40 s after them:

← {"id":"t1","channel":"trades","chain":"sol","token":"<mint>","type":"retract",
   "data":[{"signature":"<sig>","wallet":"<wallet>","slot":452995200,"reason":"abandoned"}]}

Remove the rows it lists, by signature + wallet (every row of that pair). A transaction that landed in another block comes again later as a new trade, with the same signature and that block’s amounts and time. Never handle a frame type you do not know as a trade. On candles the same event can bring a fresh snapshot, its candles built again without the lost slot; token, launchpad and wallet send nothing new for it.

GET

WebSocket

curl --request GET \
  --url https://api.raze.bot/v1/ws \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.raze.bot/v1/ws', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.raze.bot/v1/ws",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.raze.bot/v1/ws"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.raze.bot/v1/ws")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "error": {
    "code": "unauthorized",
    "message": "missing or unknown API key (send it as x-api-key)"
  }
}

{
  "error": {
    "code": "server_busy",
    "message": "the server is at capacity, retry in 30 s"
  }
}

One socket, up to 200 channels. Protocol, frames and examples: WebSocket guide. Channels and their frames: Channels.

Authorizations

x-api-key

string

header

required

Query Parameters

apiKey

string

The key, for clients that cannot set headers

channel

enum<string>

Available options:

trades,

candles,

token,

launchpad,

prices,

wallet

chain

string

token

string

interval

string

unit

string

board

string

wallet

string

Response

Switching protocols