wiki/exchanges/prediction/limitless.md
<a name="limitless" id="limitless"></a>
Kind: global class
Extends: <code>Exchange</code>
<a name="fetchMarkets" id="fetchmarkets"></a>
fetches all active limitless markets paginated and returns one CCXT market per child market, each containing a list of outcome objects (YES/NO)
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - an array of objects representing market data
See: https://docs.limitless.exchange/api-reference/markets/get-active-markets
| Param | Type | Required | Description |
|---|---|---|---|
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
| params.query | <code>string</code> | No | a single search query string to filter markets by |
| params.queries | <code>Array<string></code> | No | multiple search query strings (alternative to query) |
| params.limit | <code>int</code> | No | max number of markets to collect (defaults to options.fetchMarketsLimit, 1000); caps the pages fetched |
limitless.fetchMarkets (params?)
<a name="fetchEvent" id="fetchevent"></a>
fetches a single prediction-market event by its market slug or address
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - a prediction event structure
See: https://docs.limitless.exchange/api-reference/markets/get-market
| Param | Type | Required | Description |
|---|---|---|---|
| id | <code>string</code> | Yes | the market slug or address |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchEvent (id, params?)
<a name="fetchTicker" id="fetchticker"></a>
fetches the current price and best bid/ask for a single outcome token, combining the market detail and order book endpoints
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - a prediction ticker structure
See
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | Yes | unified outcome like TRUMP_OUT_PRESIDENT_2027:YES or an outcome token id |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchTicker (outcome, params?)
<a name="fetchTickers" id="fetchtickers"></a>
fetches tickers for multiple outcome tokens, grouping requested outcomes by their parent market (two requests per market: detail + order book)
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - a dictionary of prediction ticker structures indexed by outcome
See
| Param | Type | Required | Description |
|---|---|---|---|
| outcomes | <code>Array<string></code> | Yes | unified outcomes or outcome token ids — required: limitless has no endpoint returning all tickers at once, so an unscoped call is not supported |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchTickers (outcomes, params?)
<a name="fetchTrades" id="fetchtrades"></a>
fetches recent public trades for a single outcome token from the market events feed
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction trade structures
See: https://docs.limitless.exchange/api-reference/trading/market-events
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | Yes | unified outcome like TRUMP_OUT_PRESIDENT_2027:YES or an outcome token id |
| since | <code>int</code> | No | timestamp in ms of the earliest trade to fetch |
| limit | <code>int</code> | No | the maximum number of trades to return |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchTrades (outcome, since?, limit?, params?)
<a name="fetchOrderBook" id="fetchorderbook"></a>
fetches the order book for a single outcome token, converting 6-decimal USDC sizes to whole units, no outcomes are quoted at 1 - price with the sides swapped
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - a prediction order book structure
See: https://docs.limitless.exchange/api-reference/trading/orderbook
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | Yes | unified outcome like TRUMP_OUT_PRESIDENT_2027:YES or an outcome token id |
| limit | <code>int</code> | No | not used by limitless fetchOrderBook |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchOrderBook (outcome, limit?, params?)
<a name="fetchOHLCV" id="fetchohlcv"></a>
fetches historical prices for a single limitless market outcome and maps them to OHLCV format, uses the interval query parameter and selects the YES/NO series that matches the requested outcome
Kind: instance method of <code>limitless</code>
Returns: <code>Array<Array<int>></code> - a list of candles ordered as timestamp, open, high, low, close, volume
See: https://docs.limitless.exchange/api-reference/trading/historical-price
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | Yes | outcome, e.g. "TRUMP_OUT:YES" |
| timeframe | <code>string</code> | Yes | the length of time each candle represents |
| since | <code>int</code> | No | timestamp in ms of the earliest candle to fetch |
| limit | <code>int</code> | No | the maximum number of candles to fetch |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchOHLCV (outcome, timeframe, since?, limit?, params?)
<a name="fetchOrders" id="fetchorders"></a>
fetches orders for the authenticated user for a single outcome
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction order structures
See: https://docs.limitless.exchange/api-reference/orders/get-user-orders
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | No | outcome, e.g. "TRUMP_OUT:YES" |
| since | <code>int</code> | No | the earliest time in ms to fetch orders for |
| limit | <code>int</code> | No | the maximum number of order structures to retrieve |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchOrders (outcome?, since?, limit?, params?)
<a name="fetchOpenOrders" id="fetchopenorders"></a>
fetches open orders for the authenticated user for a single outcome
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction order structures
See: https://docs.limitless.exchange/api-reference/orders/get-user-orders
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | No | outcome, e.g. "TRUMP_OUT:YES" |
| since | <code>int</code> | No | the earliest time in ms to fetch orders for |
| limit | <code>int</code> | No | the maximum number of order structures to retrieve |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchOpenOrders (outcome?, since?, limit?, params?)
<a name="fetchClosedOrders" id="fetchclosedorders"></a>
fetches closed orders for the authenticated user for a single outcome
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction order structures
See: https://docs.limitless.exchange/api-reference/orders/get-user-orders
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | No | outcome, e.g. "TRUMP_OUT:YES" |
| since | <code>int</code> | No | the earliest time in ms to fetch orders for |
| limit | <code>int</code> | No | the maximum number of order structures to retrieve |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchClosedOrders (outcome?, since?, limit?, params?)
<a name="fetchOrdersByIds" id="fetchordersbyids"></a>
fetch orders by the list of order id
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction order structures
See: https://docs.limitless.exchange/api-reference/trading/order-status-batch
| Param | Type | Required | Description |
|---|---|---|---|
| ids | <code>Array<string></code> | Yes | list of order id |
| outcome | <code>string</code> | No | market outcome, e.g. "TRUMP_OUT:YES" |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchOrdersByIds (ids, outcome?, params?)
<a name="fetchOrder" id="fetchorder"></a>
fetches information on an order made by the user
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - a prediction order structure
See: https://docs.limitless.exchange/api-reference/trading/order-status-batch
| Param | Type | Required | Description |
|---|---|---|---|
| id | <code>string</code> | Yes | the order id |
| outcome | <code>string</code> | No | market outcome, e.g. "TRUMP_OUT:YES" |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchOrder (id, outcome?, params?)
<a name="fetchAccounts" id="fetchaccounts"></a>
query for account id and info
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of [account structures]
See: https://docs.limitless.exchange/api-reference/portfolio/get-current-profile
| Param | Type | Required | Description |
|---|---|---|---|
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchAccounts (params?)
<a name="createOrder" id="createorder"></a>
places a limit or market order on limitless for the given outcome token
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - a prediction order structure
See: https://docs.limitless.exchange/api-reference/orders/create-order
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | Yes | outcome, e.g. "TRUMP_OUT:YES" |
| type | <code>string</code> | Yes | 'limit' or 'market' |
| side | <code>string</code> | Yes | 'buy' or 'sell' |
| amount | <code>float</code> | Yes | amount of outcome tokens |
| price | <code>float</code> | No | limit price (0–1 range) |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.createOrder (outcome, type, side, amount, price?, params?)
<a name="approve" id="approve"></a>
sets the on-chain ERC20 collateral (USDC) allowance for the limitless exchange contract on Base, which is required before an EOA maker can place orders ("Insufficient collateral allowance" otherwise). Sends a real on-chain transaction signed with the privateKey and waits for the receipt
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - the transaction receipt
| Param | Type | Required | Description |
|---|---|---|---|
| params | <code>object</code> | No | extra parameters |
| params.token | <code>string</code> | No | the collateral token address (default USDC on Base) |
| params.spender | <code>string</code> | No | the exchange contract to approve (default the limitless CTF exchange); read from a market's venue when omitted |
| params.owner | <code>string</code> | No | the token holder address (default this.walletAddress or the address derived from the privateKey) |
| params.amount | <code>float</code> | No | the allowance in USDC (default: unlimited / maxUint256) |
| params.rpcUrl | <code>string</code> | No | the Base RPC url to broadcast through |
| params.gasLimit | <code>string</code> | No | gas limit hex for the approve tx (default '0x186a0') |
limitless.approve (params?)
<a name="cancelOrder" id="cancelorder"></a>
cancels a single open order by id
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - a prediction order structure
See: https://docs.limitless.exchange/api-reference/orders/cancel-order
| Param | Type | Required | Description |
|---|---|---|---|
| id | <code>string</code> | Yes | order id |
| outcome | <code>string</code> | No | outcome, e.g. "TRUMP_OUT:YES" |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.cancelOrder (id, outcome?, params?)
<a name="redeem" id="redeem"></a>
redeem a resolved winning position back to collateral (gasless — the operator settles on-chain)
Kind: instance method of <code>limitless</code>
Returns: <code>object</code> - the raw redemption response
See: https://docs.limitless.exchange/api-reference/portfolio/redeem
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | No | a unified outcome on the resolved market to redeem (used to resolve the market conditionId) |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
| params.conditionId | <code>string</code> | No | the CTF condition id (bytes32 hex) to redeem directly, instead of resolving it from an outcome |
limitless.redeem (outcome?, params?)
<a name="cancelOrders" id="cancelorders"></a>
cancel multiple orders at the same time
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction order structures
See: https://docs.limitless.exchange/api-reference/trading/cancel-batch
| Param | Type | Required | Description |
|---|---|---|---|
| ids | <code>Array<string></code> | Yes | order ids |
| outcome | <code>string</code> | No | unified market outcome, default is undefined |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.cancelOrders (ids, outcome?, params?)
<a name="cancelAllOrders" id="cancelallorders"></a>
cancels all open orders for one market slug
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction order structures
See: https://docs.limitless.exchange/api-reference/orders/cancel-all-orders
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | No | outcome, e.g. "TRUMP_OUT:YES" |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
| params.slug | <code>string</code> | No | the market slug to cancel all orders for |
limitless.cancelAllOrders (outcome?, params?)
<a name="fetchMyTrades" id="fetchmytrades"></a>
fetch all trades made by the user
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction trade structures
See: https://docs.limitless.exchange/api-reference/trades/get-trades
| Param | Type | Required | Description |
|---|---|---|---|
| outcome | <code>string</code> | No | outcome, e.g. "TRUMP_OUT:YES" |
| since | <code>int</code> | No | the earliest time in ms to fetch trades for |
| limit | <code>int</code> | No | the maximum number of trades structures to retrieve |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchMyTrades (outcome?, since?, limit?, params?)
<a name="fetchPositions" id="fetchpositions"></a>
fetches open positions for the authenticated limitless user from the portfolio endpoint
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - a list of prediction position structures
See: https://docs.limitless.exchange/api-reference/portfolio/get-positions
| Param | Type | Required | Description |
|---|---|---|---|
| outcomes | <code>Array<string></code> | No | filter by outcome ids or outcomes |
| params | <code>object</code> | No | extra parameters specific to the exchange API endpoint |
limitless.fetchPositions (outcomes?, params?)
<a name="fetchEvents" id="fetchevents"></a>
fetches prediction-market events matching the given scope (query/queries/tags/eventId/slug — required) and caches their markets and outcomes on the instance
Kind: instance method of <code>limitless</code>
Returns: <code>Array<object></code> - an array of event structures
See: https://docs.limitless.exchange/api-reference/markets/search
| Param | Type | Required | Description |
|---|---|---|---|
| params | <code>object</code> | No | extra exchange-specific parameters |
| params.query | <code>string</code> | No | a single search term; an eventId/slug does a direct lookup and tags resolve to limitless categories, paging only those categories' listings |
| params.queries | <code>Array<string></code> | No | multiple search terms (alternative to query) |
| params.tags | <code>Array<string></code> | No | category names to scope by (matched against GET /categories, e.g. ['crypto']) |
| params.eventId | <code>string</code> | No | direct lookup by market address or slug |
| params.limit | <code>int</code> | No | maximum number of markets per query, defaults to 50 |
limitless.fetchEvents (params?)