CCXT
JavaScript Examples

Prediction Limitless End To End

Prediction Limitless End To End — CCXT JavaScript code example.

// @NO_AUTO_TRANSPILE
// Limitless prediction end-to-end example (read market data + place/fetch/cancel one order)
//
// Limitless is a CLOB prediction market on Base. Auth has two parts:
//   - REST auth: an HMAC API token (apiKey = tokenId, secret) — see
//     https://docs.limitless.exchange/developers/authentication . Mint it from the
//     limitless.exchange "API Tokens" tab (or, headless, via /auth/api-tokens/derive).
//   - Order signing: an L1 privateKey (ECDSA / EIP-712). For a plain EOA profile the maker
//     is your account address; for a smart-wallet profile the embedded owner key signs.
//
// One-time on-chain setup: the maker must approve USDC (collateral) to the limitless
// exchange contract on Base, otherwise orders are rejected with "Insufficient collateral
// allowance". Do this once from the limitless UI (or any wallet) before trading.
//
// Flow:
//   1. load markets + the authenticated account (loadAccounts)
//   2. pick an outcome with a live two-sided book
//   3. fetch the order book, ticker and recent trades for that outcome
//   4. place a resting limit BUY far below the book, confirm it is open, then cancel it
//
// Usage:
//   LIMITLESS_APIKEY=... LIMITLESS_SECRET=... LIMITLESS_PRIVATEKEY=0x... \
//   npx tsx examples/ts/prediction-limitless-end-to-end.ts
import ccxt from '../../js/ccxt.js';
const MAX_NOTIONAL_USD = 25; // hard cap per trade
const ORDER_SIZE_SHARES = 110; // 110 * 0.05 = 5.5 USD notional, above the ~100-share minimum
1;
async function main() {
    const apiKey = process.env['LIMITLESS_APIKEY'];
    const secret = process.env['LIMITLESS_SECRET'];
    const privateKey = process.env['LIMITLESS_PRIVATEKEY']; // Private Key of the EOA wallet, smart wallets not support for now
    if (!apiKey || !secret || !privateKey) {
        console.log('Set LIMITLESS_APIKEY, LIMITLESS_SECRET and LIMITLESS_PRIVATEKEY env vars first.');
        return;
    }
    const exchange = new ccxt.prediction.limitless({
        'apiKey': apiKey,
        'secret': secret,
        'privateKey': privateKey,
    });
    await exchange.loadMarkets();
    await exchange.loadAccounts();
    // 1) pick an outcome with a live two-sided book and an ask high enough that a 0.05 buy
    //    cannot cross it; skip the rapid-expiry "_MIN_" markets ----------------------------
    const outcomeKeys = Object.keys(exchange.outcomes || {});
    let chosen = undefined;
    let probes = 0;
    for (const key of outcomeKeys) {
        if (probes >= 150) {
            break;
        }
        if (key.indexOf('_MIN_') !== -1) {
            continue;
        }
        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;
    console.log('outcome:', symbol);
    console.log('orderbook bid/ask:', chosen.orderbook.bids[0], '/', chosen.orderbook.asks[0]);
    // 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 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, confirm it, then cancel --------------
    const price = 0.05; // far below 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 open = await exchange.fetchOpenOrders(symbol);
        console.log('open orders for outcome:', open.length);
    }
    finally {
        if (order && order.id) {
            const canceled = await exchange.cancelOrder(order.id, symbol);
            console.log('canceled: id', canceled.id, '| status', canceled.status);
        }
    }
}
main();