Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.delphimarkets.com/llms.txt

Use this file to discover all available pages before exploring further.

Limitless runs on Base (Coinbase’s L2) and uses a direct EOA wallet model — no Safe or smart wallet wrapping. Orders are EIP-712 signed by your EOA itself.

​
At a glance

ChainBase (chainId 8453)
Wallet modelEOA (direct)
Quote tokenUSDC (6 decimals)
SigningClient-side (EIP-712)
AuthLimitless API key + HMAC secret + EOA private key

​
Prerequisites

  • A Limitless account (limitless.exchange)
  • USDC on Base in your EOA
  • Your Limitless API key and HMAC secret (from your account settings)
  • The EOA private key associated with your Limitless account
  • Your Limitless ownerId — fetch from GET /profiles on the Limitless API

​
One-time setup: register credentials

import { DelphiClient } from '@delphimarkets/sdk';
import { createWalletClient, http } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { base } from 'viem/chains';

const account = privateKeyToAccount(`0x${process.env.LIMITLESS_PRIVATE_KEY!}`);
const walletClient = createWalletClient({ account, chain: base, transport: http() });

const client = new DelphiClient({
  apiKey: process.env.DELPHI_API_KEY!,
  baseUrl: 'https://api.delphiterminal.co',
});

await client.registerCredentials('limitless', {
  api_key: process.env.LIMITLESS_API_KEY!,
  api_secret: process.env.LIMITLESS_API_SECRET!,    // HMAC secret
  api_passphrase: '',                                // unused
  signer_address: account.address,                   // your EOA
});
Run once per user. The credentials are stored encrypted server-side.

​
Approving USDC

Your EOA must approve the Limitless CTF Exchange contract (0x05c748E2f4DcDe0ec9Fa8DDc40DE6b867f923fa5) to spend USDC on Base. This is a standard ERC-20 approval. Most users do this through the Limitless UI on first deposit. If you’ve never traded on Limitless from this EOA, place a tiny test trade through their UI to trigger the approval.

​
Build and place an order

import { DelphiClient, buildLimitlessOrder } from '@delphimarkets/sdk';
import { createWalletClient, http } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { base } from 'viem/chains';

const account = privateKeyToAccount(`0x${process.env.LIMITLESS_PRIVATE_KEY!}`);
const walletClient = createWalletClient({ account, chain: base, transport: http() });

const signedOrder = await buildLimitlessOrder(
  {
    marketSlug: 'trump-out-as-president-before-2027-1768933068297',
    tokenId: '56154308...',  // outcome token uint256
    side: 'BUY',
    price: 0.10,              // 0.01 to 0.99
    size: 1,                  // USDC amount, human-readable
    ownerId: 1292635,         // from Limitless /profiles endpoint
    feeRateBps: 300,          // optional, default 300 (3%)
  },
  walletClient,
);

const order = await client.placeOrder({
  exchange: 'limitless',
  market_id: 'trump-out-as-president-before-2027-1768933068297',
  order_type: 'GTC',
  signed_order: signedOrder,
});

console.log(`Placed: ${order.order_id} (${order.status})`);

​
Build parameters

FieldTypeDescription
marketSlugstringLimitless market slug (URL fragment from the market page).
tokenIdstringOutcome token ID (uint256 decimal string).
side'BUY' | 'SELL'
pricenumberPrice per share in [0.01, 0.99].
sizenumberUSDC amount, human-readable (e.g. 1 for 1 USDC).
ownerIdnumberYour Limitless owner ID. Required.
feeRateBpsnumber?Default 300 (3%). Limitless’s standard fee.

​
How to find your ownerId

Hit Limitless’s /profiles endpoint with your account address: 
const res = await fetch(
  `https://api.limitless.exchange/profiles/${account.address}`,
);
const { id } = await res.json();
console.log(id); // your ownerId
Cache this value — it doesn’t change.

​
Query and cancel

const status = await client.getOrder(order.order_id, 'limitless');
const all = await client.listOrders('limitless');
await client.cancelOrder(order.order_id, 'limitless');

​
Common pitfalls

Limitless uses direct EOA signing, not Safe wallet wrapping. The SDK sets signatureType: 0 automatically. If you’re hand-rolling a payload, don’t copy signatureType: 2 from a Polymarket example — the signature verifier will reject it.
Unlike Polymarket and Predict.fun (which use uint256 strings), Limitless’s API uses JavaScript numbers for salt, makerAmount, takerAmount, etc. The SDK handles this for you. If hand-rolling, don’t quote them as strings.
Limitless ties orders to their internal profile ID, not your wallet address. Fetch your id from GET /profiles/{address} once and cache it. If you switch wallets, your ownerId changes too.
Limitless’s standard fee is 300 bps (3%) — this is taken from the maker side. The SDK defaults to 300 if you don’t specify feeRateBps. Markets may occasionally run at a different rate; check the market metadata.

​
API reference