Prediction Hyperliquid End To End

// @NO_AUTO_TRANSPILE
// Hyperliquid prediction end-to-end example (read market data + place/fetch/cancel one order)
//
// Hyperliquid's outcome (prediction) markets trade as spot tokens on the L1. Auth is the
// standard hyperliquid wallet signing: a walletAddress + an L1 privateKey (ECDSA secp256k1).
//
// Flow:
//   1. load markets, read the USDC balance
//   2. pick an outcome with a live two-sided book
//   3. fetch the order book, ticker, OHLCV and recent trades for that outcome
//   4. place a resting limit BUY far below the book, fetch it back, then cancel it
//
// Usage (testnet is the default; set HYPERLIQUID_SANDBOX=false for mainnet — the wallet must
// be funded/onboarded on whichever network you choose):
//   HYPERLIQUID_WALLETADDRESS=0x... HYPERLIQUID_PRIVATEKEY=0x... \
//   npx tsx examples/ts/prediction-hyperliquid-end-to-end.ts
import ccxt from '../../js/ccxt.js';
const MAX_NOTIONAL_USD = 25; // hard cap per trade
const ORDER_SIZE_SHARES = 220; // 220 * 0.05 = 11 USD notional, under the cap
async function main() {
    const walletAddress = process.env['HYPERLIQUID_WALLETADDRESS'];
    const privateKey = process.env['HYPERLIQUID_PRIVATEKEY'];
    if (!walletAddress || !privateKey) {
        console.log('Set HYPERLIQUID_WALLETADDRESS and HYPERLIQUID_PRIVATEKEY env vars first.');
        return;
    }
    const exchange = new ccxt.prediction.hyperliquid({
        'walletAddress': walletAddress,
        'privateKey': privateKey,
    });
    // outcome markets are deployed on both testnet and mainnet; testnet is the default
    const sandbox = (process.env['HYPERLIQUID_SANDBOX'] || 'true') !== 'false';
    exchange.setSandboxMode(sandbox);
    console.log('network:', sandbox ? 'testnet' : 'mainnet');
    await exchange.loadMarkets();
    const balance = await exchange.fetchBalance();
    console.log('balance USDC:', JSON.stringify(balance['USDC']));
    // 1) pick an outcome with a live two-sided book and an ask high enough that a
    //    0.05 buy cannot cross it -----------------------------------------------------------
    const outcomeKeys = Object.keys(exchange.outcomes || {});
    let chosen = undefined;
    let probes = 0;
    for (const key of outcomeKeys) {
        if (probes >= 60) {
            break;
        }
        probes += 1;
        try {
            const ob = await exchange.fetchOrderBook(key);
            if (ob.bids.length > 0 && ob.asks.length > 0 && ob.asks[0][0] >= 0.30) {
                chosen = { 'outcome': key, 'orderbook': ob };
                break;
            }
        }
        catch (e) { /* keep probing */ }
    }
    if (chosen === undefined) {
        console.log('Could not find an outcome with a suitable two-sided order book right now.');
        return;
    }
    const symbol = chosen.outcome;
    const bestBid = chosen.orderbook.bids[0];
    const bestAsk = chosen.orderbook.asks[0];
    console.log('\noutcome:', symbol);
    console.log('orderbook bid/ask:', bestBid, '/', bestAsk);
    // 2) market data for the chosen outcome -------------------------------------------------
    console.log('\n--- market data ---');
    try {
        const ticker = await exchange.fetchTicker(symbol);
        console.log('ticker bid/ask/last:', ticker.bid, '/', ticker.ask, '/', ticker.last);
    }
    catch (e) {
        console.log('ticker:        n/a (' + e.constructor.name + ')');
    }
    try {
        const ohlcv = await exchange.fetchOHLCV(symbol, '1h', undefined, 3);
        console.log('ohlcv (1h x' + ohlcv.length + '): last close', ohlcv.length ? ohlcv[ohlcv.length - 1][4] : 'n/a');
    }
    catch (e) {
        console.log('ohlcv:         n/a (' + e.constructor.name + ')');
    }
    try {
        const trades = await exchange.fetchTrades(symbol, undefined, 3);
        console.log('recent trades:', trades.length, trades[0] ? ('last @ ' + trades[0].price) : '');
    }
    catch (e) {
        console.log('trades:        n/a (' + e.constructor.name + ')');
    }
    // 3) place a resting limit BUY far below the book, fetch it, then cancel ----------------
    const price = 0.05; // far below any bid >= 0.10 and any ask >= 0.30, so it cannot fill
    const notional = ORDER_SIZE_SHARES * price;
    console.log('\n--- order ---');
    console.log('placing limit BUY', ORDER_SIZE_SHARES, 'shares @', price, '(notional', notional.toFixed(2), 'USD)');
    if (notional >= MAX_NOTIONAL_USD) {
        console.log('ABORT: notional >= ' + MAX_NOTIONAL_USD + ' USD safety cap.');
        return;
    }
    let order = undefined;
    try {
        order = await exchange.createOrder(symbol, 'limit', 'buy', ORDER_SIZE_SHARES, price);
        console.log('placed:  id', order.id, '| status', order.status);
        const fetched = await exchange.fetchOrder(order.id, symbol);
        console.log('fetched: id', fetched.id, '| status', fetched.status, '| remaining', fetched.remaining);
    }
    finally {
        if (order && order.id) {
            const canceled = await exchange.cancelOrder(order.id, symbol);
            console.log('canceled: id', canceled.id, '| status', canceled.status);
        }
    }
}
main();