Quickstart

import { DeriveClient } from '@derivexyz/derive-ts';
import { JsonRpcProvider, Wallet } from 'ethers';

const client = new DeriveClient({
  network: 'testnet',
  wallet: process.env.PRIVATE_KEY!,
});

// Find USDC's spot asset and the prime-universe (risk universe 1) manager.
const currencies = await client.marketData.getAllCurrencies();
const usdc = currencies.find((c) => c.currency === 'USDC')!;
const spotAsset = usdc.spot.find((s) => s.name === 'USDC') ?? usdc.spot[0];

const prime = usdc.managers.find((m) => m.risk_universe_id === 1)!;
const managerId = prime.sm; // standard-margin manager for the prime universe

# Coming soon.

// Coming soon.

// Snapshot subaccounts so we can spot the new one after depositing.
const knownSubaccountIds = await client.subaccounts.list();

// Your wallet signs the on-chain ActionManager tx (ERC-20 approve + deposit).
const rpcUrl = 'https://ethereum-sepolia-rpc.publicnode.com';
const signer = new Wallet(
  process.env.PRIVATE_KEY!,
  new JsonRpcProvider(rpcUrl),
);
await client.deposits.contractCall.depositToNewSubaccount({
  signer,
  asset: spotAsset.address,
  amount: '100',
  managerId,
});

// The exchange assigns the subaccount id once it sees the deposit (~2 min).
const subaccountId = await client.deposits.awaitNewSubaccount({
  knownSubaccountIds,
});
console.log(`account ready: subaccount ${subaccountId}`);

# Coming soon.

// Coming soon.

await client.connect(); // open the websocket
await client.login(); // authenticate the session — required for private/*

const { order } = await client.orders.place({
  subaccountId,
  instrumentName: 'ETH-PERP',
  direction: 'buy',
  amount: '1',
  limitPrice: '3100', // rests below market
});
console.log(`${order.order_id}: ${order.order_status} @ ${order.limit_price}`);

await client.close();

# Coming soon.

// Coming soon.