Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shuriken.trade/llms.txt

Use this file to discover all available pages before exploring further.

The Shuriken API v2 gives you direct access to the same multi-chain trading engine that powers the Terminal, Telegram Bot, and AI Agent Kit. Build trading bots, automate strategies, or integrate real-time token data into your own tools through REST endpoints and real-time WebSocket streams.
All API requests require a Bearer token. Create an Agent Key from the Terminal to get started.

​
SDKs

The fastest way to get started is with an official SDK. They handle authentication, typed responses, WebSocket connection management, and automatic reconnection — so you can focus on your trading logic instead of protocol details. See the SDKs page for usage snippets and quickstart repos.

TypeScript SDK

REST + WebSocket client with typed events. Install via npm install @shuriken/sdk-ts.

Rust SDK

Async REST + WebSocket with futures::Stream support. Add shuriken-sdk to your Cargo.toml.

​
CLI

A thin command-line client for the same v2 developer surface — useful for quick lookups, scripting, and testing without writing SDK code. HTTP only; WebSocket streams require an SDK or direct connection. The installer drops a single shuriken binary in ~/.local/bin and supports in-place updates via shuriken update apply. See the CLI page for installer flags, auth, and update details. 
curl -fsSL https://cdn.shuriken.trade/shuriken-cli/install.sh | sh
Pin a version with SHURIKEN_VERSION=v0.3.2 or change the install location with SHURIKEN_INSTALL_DIR="$HOME/bin". Pass either as an environment variable on the same line as sh.

​
Base URL

All endpoints live under a single base URL with version prefix: 
https://api.shuriken.trade/api/v2

​
Supported chains

Solana

SVM

Base

EVM

BSC

EVM

Monad

EVM

​
Authentication

Every request must include your API key as a Bearer token in the Authorization header: 
curl -X GET "https://api.shuriken.trade/api/v2/account/me" \
  -H "Authorization: Bearer YOUR_API_KEY"
Read the full Authentication guide for setup instructions and security best practices.

​
Endpoint groups

Account

Manage your profile, wallets, trade settings, and check API key usage.

Portfolio

View token balances, trade history, PnL summaries, and open positions across all chains.

Swap

Get quotes, build transactions, execute swaps, and track execution status.

Tokens

Search tokens, fetch metadata, prices, OHLCV charts, pool data, and trading stats.

Trigger Orders

Create and manage limit orders and stop-loss triggers based on price, market cap, or liquidity.

Perpetuals

Trade perpetual futures with leverage, manage positions, and track fills and funding.

WebSocket

Real-time streams for swaps, balances, pool data, alpha signals, and portfolio updates.

Tasks

Poll execution status for async operations like swaps and approvals.

​
Response format

All successful responses follow the same envelope: 
{
  "data": { ... },
  "requestId": "req_abc123",
  "pagination": null
}
When pagination applies, the pagination field includes page, limit, hasMore, and an optional total. Errors use a consistent format too - see the Errors reference for details.
Every response includes a requestId. Include it when contacting support to speed up debugging.