Solana Sniper Bot API Reference
The Solana Sniper Bot REST API gives developers programmatic access to token detection data, safety scoring, bot sessions, and trade history. Build custom dashboards, integrate alerts, or extend Solana Sniper Bot with your own tooling.
https://api.sniperbotsolana.com/v1
All responses are JSON. Request bodies (POST/PUT) must be JSON with
Content-Type: application/json.All API requests must use HTTPS. HTTP requests will receive a 301 redirect.
All timestamps are ISO 8601 in UTC:
2026-03-15T14:23:11ZAll token and trade data is sourced from Solana Mainnet-Beta unless otherwise noted.
Authentication
All API requests require an API key sent as a request header. You can generate and manage API keys in the Settings → API section of your dashboard.
X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
API keys are prefixed with sk_live_ for production and sk_test_ for sandbox. Test keys return mock data and do not execute real transactions.
Rate Limits
Rate limit headers are included in every response:
X-RateLimit-Limit: 60 X-RateLimit-Remaining: 43 X-RateLimit-Reset: 1742046480
When exceeded, the API returns 429 Too Many Requests with a Retry-After header indicating seconds until the window resets.
Error Codes
The API uses conventional HTTP status codes. All error responses include a JSON body:
{
"success": false,
"error": {
"code": "INVALID_MINT",
"message": "The provided mint address is not a valid base58-encoded Solana public key."
}
}
Token Discovery
/tokens/detected
Recently detected tokens with safety scores
Returns a paginated list of tokens detected by the Solana Sniper Bot monitoring engine across all enabled DEXes, ordered by detection time descending.
limitintegeroptional20dexstringoptionalpump.fun · raydium · bonk.fun · orca · jupitermin_scorefloatoptionalsincetimestampoptionalcurl -X GET "https://api.sniperbotsolana.com/v1/tokens/detected?limit=2&dex=pump.fun" \
-H "X-API-Key: sk_live_xxxxxxxxxxxx"
{
"success": true,
"data": [
{
"mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"symbol": "KEKE",
"name": "Keke Token",
"detected_at": "2026-03-15T14:23:11Z",
"dex": "pump.fun",
"liquidity_sol": 18.4,
"safety_score": 6.8,
"market_cap_usd": 24180,
"holders": 47
}
],
"count": 1,
"next_cursor": "eyJpZCI6IjEyMyJ9"
}
/tokens/{mint}/score
Full safety analysis for a specific token
Returns the complete 12-point safety score breakdown for any Solana token mint address.
mintstringrequiredcurl -X GET "https://api.sniperbotsolana.com/v1/tokens/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU/score" \
-H "X-API-Key: sk_live_xxxxxxxxxxxx"
{
"success": true,
"data": {
"mint": "7xKXtg2CW87...",
"overall_score": 6.8,
"checks": {
"mint_authority_revoked": true,
"freeze_authority_revoked": true,
"holder_concentration_ok": true,
"lp_locked": false,
"honeypot_clear": true,
"deployer_clean": true,
"dev_wallet_ok": true,
"lp_burned": false,
"no_bundle": true,
"tax_ok": true,
"has_social": false,
"metadata_valid": true
},
"scored_at": "2026-03-15T14:23:09Z"
}
}
Bot Control
/bot/session
Start a new bot session
Initiates a new automated sniping session with the specified configuration. Returns a session ID used to monitor or stop the session.
config_idstringrequiredGET /config).dexesarrayoptionalcurl -X POST "https://api.sniperbotsolana.com/v1/bot/session" \
-H "X-API-Key: sk_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"config_id": "cfg_balanced_01",
"dexes": ["pump.fun", "raydium"]
}'
{
"success": true,
"data": {
"session_id": "sess_8f3k2mN9p",
"status": "active",
"started_at": "2026-03-15T14:30:00Z",
"config_id": "cfg_balanced_01",
"dexes": ["pump.fun", "raydium"]
}
}
/bot/session/{session_id}
Stop an active bot session
Gracefully stops a bot session. Open positions are not automatically closed — the bot stops acquiring new positions but exits existing ones according to configured TP/SL rules.
curl -X DELETE "https://api.sniperbotsolana.com/v1/bot/session/sess_8f3k2mN9p" \
-H "X-API-Key: sk_live_xxxxxxxxxxxx"
{
"success": true,
"data": {
"session_id": "sess_8f3k2mN9p",
"status": "stopped",
"stopped_at": "2026-03-15T15:12:44Z",
"trades_executed": 7,
"net_pnl_sol": 0.183
}
}
Trade History
/trades
Paginated list of all executed trades
Returns buy and sell transactions executed by all bot sessions associated with this API key, ordered by execution time descending.
limitintegeroptional50typestringoptionalbuy or sellsession_idstringoptionalcurl -X GET "https://api.sniperbotsolana.com/v1/trades?limit=2" \
-H "X-API-Key: sk_live_xxxxxxxxxxxx"
{
"success": true,
"data": [
{
"trade_id": "trd_m3kL9fPq",
"type": "sell",
"mint": "7xKXtg2CW87...",
"symbol": "KEKE",
"sol_amount": 0.482,
"trigger": "take_profit_2",
"pnl_sol": 0.082,
"pnl_pct": 20.5,
"fee_sol": 0.00082,
"tx_sig": "5K8pNm...",
"executed_at": "2026-03-15T14:41:07Z"
}
],
"total": 47,
"next_cursor": "eyJpZCI6IjQ3In0="
}
Webhooks
Configure a webhook URL to receive real-time event notifications as HTTP POST requests to your endpoint. This is an alternative to polling the API.
Configure webhooks via POST /webhooks with your endpoint URL and list of events. Webhook requests include a X-Solana Sniper Bot-Signature header for verification.