dex_getOrderbooks | Tempo

​

Parameters

• params — pagination object:
  • limit — (optional) maximum number of orderbooks to return (default: 10, max: 100)
  • cursor — (optional) cursor for pagination from previous response
  • filters — (optional) filter object:
    • baseToken — filter by base token address
    • quoteToken — filter by quote token address
    • bestAskTick — filter by best ask tick range
    • bestBidTick — filter by best bid tick range
    • spread — filter by spread range

​

Response

• result — response object:
  • nextCursor — cursor for the next page (null if no more results)
  • orderbooks — array of orderbook objects:
    • baseToken — base token address
    • quoteToken — quote token address
    • bookKey — unique orderbook identifier (used as cursor)
    • bestAskTick — best (lowest) ask price tick
    • bestBidTick — best (highest) bid price tick
    • spread — difference between best ask and best bid ticks

​

Use case

• Discovering available trading pairs on the Tempo Stablecoin Exchange
• Monitoring market spreads across stablecoin pairs
• Building DEX aggregator interfaces
• Analyzing liquidity distribution

​

dex_getOrderbooks code examples

const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);

const getOrderbooks = async () => {
    // Get all orderbooks
    const result = await provider.send("dex_getOrderbooks", [{
      limit: 10
    }]);

    console.log(`Found ${result.orderbooks.length} orderbooks`);
    for (const book of result.orderbooks) {
      console.log(`Pair: ${book.baseToken} / ${book.quoteToken}`);
      console.log(`  Best Bid Tick: ${book.bestBidTick}`);
      console.log(`  Best Ask Tick: ${book.bestAskTick}`);
      console.log(`  Spread: ${book.spread} ticks`);
    }
  };

getOrderbooks();