Lixer

Lixer

Lixer is a comprehensive SDK and analytics platform that provides real-time and historical swap data across all major DEXs supported by LiquidLabs. Built on top of Goldsky's infrastructure, Lixer delivers decoded swap events with sub-second latency, making it the ideal solution for analytics dashboards, MEV bots, yield optimizers, and DeFi applications.

X account  Gitbook

Architecture 

Lixer is built as a multi-component system designed for scalability and real-time data processing:

Data Indexing layer

• Historical Data:Utilizes Goldsky subgraphs to index historical swap events from multiple DEX protocols.

• Real-time Data:Leverages Goldsky mirror pipelines with direct log indexing for live swap data.

• Event Decoding:Automatically decodes raw blockchain logs into structured swap event data.

Core Components:

1. SDK npm package link

A lightweight JavaScript/Node.js SDK available on npm that provides instant access to Lixer’s data.

js:

const LixerSDK = require('@lixersdk/sdk');
const lixer = new LixerSDK();


// Get swap data
const swaps = await lixer.swaps().getAll({ limit: 100 });


// Get pool information
const pools = await lixer.pools().getAll();


// Subscribe to real-time events
const ws = await lixer.websocket().connect();

ts:

import LixerSDK from '@lixersdk/sdk';


const lixer = new LixerSDK();


export const dashboardApi = {
  getPools: async (): Promise => {
    const sdkPools = await lixer.pools().getAll();


    return sdkPools.map((pool: any) => ({
      address: pool.address,
      metadata: pool.metadata,
      ...pool,
    }));
  },
};

Features:

• Zero configuration (works out of the box)

• REST API + WebSocket support

• Built-in error handling & retry logic

• TypeScript compatible

• Hosted infrastructure (no server setup required)

1. API Server (/server)

A robust Express.js backend deployed on Render that serves as the data access layer.

Key Services

• Swap Data Service (retrieval + processing)

• Database Service (PostgreSQL + real-time notifications)

• WebSocket Server (live streaming to clients)

• Swap Decoder (powered by ethers.js)

Endpoints

• GET /swaps → Retrieve swap events

• GET /pools → Pool info & stats

• GET /stats → Global/pool statistics

• GET /timeseries → Time-series analytics

• GET /health → Service monitoring

• WS /ws → Real-time stream

1. Subgraphs (/subgraphs)subgraph link

• GraphQL-based indexing for historical data

• HyperSwap Subgraph indexes factory & pool events

• Schema Definition for pools, swaps, tokens

• Event Handlers process on-chain events

1.    Mirror Pipeline

• Real-time ingestion via Goldsky mirror pipeline

• Direct log indexing from pools

• PostgreSQL sink for structured storage

• Instant triggers for notifications,subscribe to notifications via mail 

1. Analytics Dashboard (/monorepo)

A professional Next.js dashboard for data visualization.

Features

• Real-time swap monitoring

• Interactive charts (ApexCharts)

• Pool analytics & performance metrics

• Responsive modern UI

Components

• Overview cards (key metrics)

• Charts (swap volume, trends)

• Real-time notifications

• Advanced filtering & search

1. Use Cases

• Analytics Dashboards → Real-time monitoring & trend analysis

• MEV Bots → Sub-second swap notifications

• Yield Optimizers → Liquidity & price impact tracking

• DeFi Applications → Zero-config integration with scalable APIs

Getting Started

Installation

npm install @lixersdk/sdk

No configuration needed — the SDK connects automatically.

Quick Start Example

const LixerSDK = require('@lixersdk/sdk');
const lixer = new LixerSDK();

// Get recent swaps
const recentSwaps = await lixer.swaps().getAll({ limit: 10 });
console.log('Recent swaps:', recentSwaps);

// Connect to stream
const ws = await lixer.websocket().connect();
ws.on('message', (data) => {
  const swapEvent = JSON.parse(data);
  console.log('New swap detected:', swapEvent);
});

TypeScript Support

import LixerSDK from '@lixersdk/sdk';


const lixer = new LixerSDK();


const swaps: SwapEvent[] = await lixer.swaps().getAll({ limit: 100 });
const pools: Pool[] = await lixer.pools().getAll();

API Documentation

Swap Events

• GET /swaps?limit=100&offset=0&pool=0x...

• GET /swaps/:id

Pool Data

• GET /pools

• GET /pools/:address/swaps

• GET /pools/:address/timeseries/swaps?interval=hour&limit=24

Statistics

• GET /stats/global

• GET /stats/pools/:address

Tracks Targeted

 Public Goods Track

Lixer is an open-source SDK and analytics platform that provides real-time and historical swap data for the Hyperliquid ecosystem. By offering reusable SDKs, APIs, and subgraphs, it empowers developers to build dashboards, bots, and DeFi apps with zero setup, directly contributing shared infrastructure to the community.

Hyperliquid Frontier Track

Lixer expands the Hyperliquid frontier by enabling new dApps, MEV bots, yield optimizers, and analytics dashboards. With real-time swap monitoring and powerful APIs, it accelerates ecosystem growth while fostering innovation in trading, community tools, and cultural adoption.

 Best Use of Goldsky

Built natively on Goldsky’s subgraphs and mirror pipelines, Lixer leverages both historical indexing and real-time log ingestion with sub-second latency. This makes it a showcase of Goldsky’s infrastructure, turning raw blockchain data into actionable insights and reliable notifications.

 Best Use of LiquidLabs

By deeply integrating with LiquidLabs-supported DEXs, Lixer delivers decoded swap events and pool analytics that developers can consume instantly via SDKs or APIs. It exemplifies LiquidLabs’ mission to power scalable, high-quality DeFi data access across the ecosystem.

Roadmap

• Advanced analytics & alerts

• Mobile SDK (React Native)

• Enhanced WebSocket filtering

• Integration with more DeFi protocols

• Python SDK

• REST API auth & rate limiting

• Historical data export

✨ Lixer

Powering the next generation of DeFi applications with real-time, reliable swap data.
Simply run:

npm install @lixersdk/sdk

…and start building. 🚀