Overview

Tomahawk API

Perps on Hyperliquid, Aster, Lighter and Pacifica with one routed order, and the Solana memecoin board, through one REST API, one WebSocket and one MCP server.

Everything the terminal does with market data, orders and Solana trades, an agent or a script can do with a scoped renko_sk_… key. A test key trades on a simulator against live market data, so you can build and run an agent with no funds and no venue connection. Every order passes the key's policy (size, daily volume, leverage, slippage, venues, markets), and the server enforces it on every request.

Careful
Paper trading is open. Live trading is not switched on yet: live keys cannot be created and live actions answer live_off. Everything in these docs runs with a test key.

Start here

The shape of it

  • REST under https://usetomahawk.xyz/api/v2. Every answer is { ok, data, ts } or { ok: false, error: { code, message }, ts }.
  • Orders are two steps: POST /orders/preview, then POST /orders with a client-generated UUID clientId. Sending the same clientId again never places a second order.
  • Money is a decimal string. Market data is a number. Times are epoch milliseconds.
  • Realtime at wss://renko-terminal-api.fly.dev/ws: books, trades, candles, your orders and fills, the Solana board.

For machines

Point a model at /llms.txt for the index or /llms-full.txt for the whole reference. The OpenAPI 3.1 document is served by the API at /api/v2/openapi.json and the tool list, with JSON schemas, at /api/v2/agent/tools. Press ⌘K to search these docs.