Breeeze Trading API
The Breeeze Trading API provides a simple HTTP interface for buying and selling Solana tokens on pump.fun or pump-amm. It returns unsigned transactions (base64) that you sign and broadcast.
Health Check
GET /health
200 OK if healthy.
Request & Response Conventions
- Headers:
Content-Type: application/json
{
"messageBase64": "<base64-encoded unsigned transaction>"
}
- Error JSON:
{
"error": "BadRequest|UpstreamError|ServerError",
"message": "Short error summary",
"detail": "First stack element + exception text (if available)",
"requestId": "<X-Request-Id value>"
}
Endpoints
1) Buy
POST /v1/buy
{
"rpc": "https://<your-rpc>",
"feePayer": "<base58 public key>",
"mint": "<base58 token mint>",
"amountSol": 0.001,
"slippagePercent": 5
}
2) Sell
POST /v1/sell
{
"rpc": "https://<your-rpc>",
"feePayer": "<base58 public key>",
"mint": "<base58 token mint>",
"sellPercent": 50,
"slippagePercent": 3
}
Common Errors
Error | HTTP | Description |
---|---|---|
BadRequest | 400 | Missing/invalid fields (e.g., malformed base58). |
UpstreamError | 502 | RPC/third-party failure during checks/sim. |
ServerError | 500 | Unexpected server exception. |
Operational Notes
A 0.3% transaction fee applies to each buy/sell (excluding pump.fun & network fees). Blockhash TTL ~90s—broadcast promptly.
