Indexer API Documentation

{
  "number": 1234567,
  "hash": "0x...",
  "parentHash": "0x...",
  "timestamp": 1705223340,
  "miner": "0x...",
  "gasUsed": "21000",
  "gasLimit": "50000000",
  "transactions": [...]
}

GET /v1/blocks/1234567
GET /v1/blocks/0x74b6359f58b54d1ce166406bdd831a39727762217fae2ac742a1698f1bcb0684

GET /v1/blocks?limit=20&offset=0

{
  "hash": "0x...",
  "blockNumber": 1234567,
  "from": "0x...",
  "to": "0x...",
  "value": "1000000000000000000",
  "gasPrice": "0",
  "gasUsed": "21000",
  "status": 1,
  "timestamp": 1705223340
}

{
  "transactionHash": "0x...",
  "blockNumber": 1234567,
  "status": 1,
  "gasUsed": "65000",
  "logs": [...]
}

{
  "totalTransactions": 1234567,
  "latestBlock": 1234567,
  "timestamp": "2026-01-16T13:00:00.000Z"
}

GET /v1/address/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb/transactions?limit=50

[
  {
    "contractAddress": "0x...",
    "symbol": "USDT",
    "name": "Tether USD",
    "balance": "1000500000",
    "balanceFormatted": "1000.5",
    "decimals": 6,
    "type": "ERC20"
  }
]

{
  "native": "1234.56",
  "tokens": [
    {
      "contractAddress": "0x...",
      "symbol": "USDT",
      "name": "Tether USD",
      "balance": "1000.5",
      "decimals": 6,
      "type": "ERC20"
    }
  ],
  "dataSource": "database_optimized"
}

class QELTIndexerClient {
  private baseURL = 'https://mnindexer.qelt.ai';

  async getLatestBlock() {
    const response = await fetch(`${this.baseURL}/v1/blocks/latest`);
    return await response.json();
  }

  async getTransaction(hash: string) {
    const response = await fetch(`${this.baseURL}/v1/transactions/${hash}`);
    return await response.json();
  }

  async getAddressTransactions(address: string, limit = 10) {
    const response = await fetch(
      `${this.baseURL}/v1/address/${address}/transactions?limit=${limit}`
    );
    return await response.json();
  }
}

// Usage
const client = new QELTIndexerClient();
const latestBlock = await client.getLatestBlock();
console.log('Latest block:', latestBlock.number);

import requests

class QELTIndexer:
    def __init__(self):
        self.base_url = 'https://mnindexer.qelt.ai'
    
    def get_latest_block(self):
        response = requests.get(f'{self.base_url}/v1/blocks/latest')
        return response.json()
    
    def get_transaction(self, tx_hash):
        response = requests.get(f'{self.base_url}/v1/transactions/{tx_hash}')
        return response.json()

# Usage
indexer = QELTIndexer()
block = indexer.get_latest_block()
print(f"Latest block: {block['number']}")

const cache = new Map();
const ttl = 300000; // 5 minutes

async function getCachedData(key, fetchFn) {
  const cached = cache.get(key);
  if (cached && Date.now() - cached.timestamp < ttl) {
    return cached.data;
  }
  const data = await fetchFn();
  cache.set(key, { data, timestamp: Date.now() });
  return data;
}

async function fetchWithRetry(url, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url);
      if (response.ok) return await response.json();
      
      if (response.status === 503 && i < maxRetries - 1) {
        await new Promise(r => setTimeout(r, 1000 * Math.pow(2, i)));
        continue;
      }
      throw new Error(`HTTP ${response.status}`);
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

const health = await fetch('https://mnindexer.qelt.ai/v1/health/ready');
const status = await health.json();

if (status.lag > 1000) {
  console.warn('Indexer is behind:', status.lag, 'blocks');
}