Quickstart

Install

npm install @zeustrade/sdk

Create a client

import { Zeus } from '@zeustrade/sdk'

const zeus = new Zeus({
  network: 'base',
  rpcUrl: process.env.RPC_URL!,
  privateKey: process.env.PRIVATE_KEY as `0x${string}`,
  apiKey: process.env.ZEUS_API_KEY
})

Without a signer the client is read only. apiKey is optional and unlocks the market-maker gateway.

Approve once

ZEUS routes trades through two plugins of its Router: the PositionRouter for market orders and the OrderBook for limit, take profit and stop loss orders. Approve both once per wallet, and the token you pay with.

const status = await zeus.setup.status()
if (!status.ready) await zeus.setup.approvePlugins()
await zeus.setup.approveToken('USDC')

Place a first trade

const receipt = await zeus.trade.marketOpen({
  market: 'ETH/USD',
  side: 'long',
  collateral: 20,
  payToken: 'USDC',
  leverage: 5,
  slippage: 0.5
})

console.log(receipt.status, receipt.fillPrice, receipt.executionMs)

The call returns when the keeper has executed the request, not when your transaction is mined. If the keeper cancels it, the call throws RequestCancelled with the receipt attached.

Try everything on the ZEUS test network first with network: 'base-sepolia'. The test USDC there can be minted freely, and a little Base Sepolia ETH pays for gas and keeper fees.

Getting started

Trading

Account

Markets and data

Liquidity

Advanced

Examples