Documentation - PoIPoE API & Platform Guide

Introduction

PoIPoE is an advanced MEV (Maximal Extractable Value) trading platform that provides institutional-grade automated trading across multiple blockchain networks. Our API enables developers to build sophisticated trading strategies and integrate with our AI-powered detection and execution engines.

Sub-Millisecond Execution

Lightning-fast transaction execution across all supported networks

AI-Powered Detection

Machine learning algorithms identify profitable opportunities in real-time

Enterprise Security

Bank-grade security with SOC 2 compliance and comprehensive auditing

Quick Example: Arbitrage Detection

// Initialize PoIPoE client
const poipoe = new PoIPoE({
    apiKey: 'your-api-key',
    network: 'mainnet'
});

// Subscribe to arbitrage opportunities
poipoe.on('arbitrage_opportunity', (opportunity) => {
    console.log('New arbitrage opportunity:', {
        pair: opportunity.pair,
        profit: opportunity.profit,
        dexes: opportunity.dexes
    });
    
    // Execute if profit exceeds threshold
    if (opportunity.profit > 1000) {
        await poipoe.executeArbitrage(opportunity);
    }
});

// Start monitoring
poipoe.startMonitoring(['ETH/USDC', 'BTC/ETH']);

Authentication

All PoIPoE API requests require authentication using API keys. You can generate and manage your API keys through the dashboard.

API Key Header

Include your API key in the request header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.poipoe.com/v1/status

JavaScript SDK

Use our official SDK for easier integration:

import { PoIPoE } from '@poipoe/sdk';

const client = new PoIPoE({
    apiKey: 'your-api-key'
});

Security Note: Never expose your API keys in client-side code. Use environment variables or secure key management services.

Quick Start

Get up and running with PoIPoE in under 5 minutes. Follow this step-by-step guide to create your first trading bot.

1

Install the SDK

npm install @poipoe/sdk
# or
yarn add @poipoe/sdk

2

Initialize Client

const poipoe = new PoIPoE({
    apiKey: process.env.POIPOE_API_KEY,
    environment: 'sandbox' // Use 'mainnet' for live trading
});

3

Create Your First Strategy

// Configure arbitrage strategy
const strategy = {
    type: 'arbitrage',
    pairs: ['ETH/USDC', 'BTC/ETH'],
    minProfit: 100, // Minimum profit in USD
    maxSlippage: 0.5 // Maximum slippage percentage
};

4

Deploy and Monitor

// Deploy strategy
const bot = await poipoe.deployBot(strategy);

// Monitor performance
bot.on('trade_executed', (trade) => {
    console.log(`Executed ${trade.type}: ${trade.profit}`);
});

API Reference

Core Endpoints

GET /v1/status Get platform status

Returns current platform status and health metrics.

{
    "status": "operational",
    "uptime": 99.99,
    "active_bots": 3247,
    "total_volume_24h": 25000000,
    "supported_networks": ["ethereum", "bsc", "polygon"]
}

POST /v1/bots/deploy Deploy trading bot

Deploy a new trading bot with specified strategy.

// Request
{
    "strategy": {
        "type": "arbitrage",
        "pairs": ["ETH/USDC"],
        "min_profit": 100
    },
    "config": {
        "max_gas_price": 100,
        "slippage_tolerance": 0.5
    }
}

// Response
{
    "bot_id": "bot_123456",
    "status": "deploying",
    "estimated_start": "2025-11-02T03:30:00Z"
}

GET /v1/bots/{id}/metrics Get bot performance metrics

Retrieve detailed performance metrics for a specific bot.

{
    "bot_id": "bot_123456",
    "total_trades": 1247,
    "success_rate": 94.7,
    "total_profit": 47293.45,
    "avg_execution_time": 12.3,
    "strategies": ["arbitrage", "liquidation"]
}

Code Examples

Arbitrage Trading

Complete arbitrage trading implementation

class ArbitrageBot {
    constructor(apiKey) {
        this.client = new PoIPoE({ apiKey });
        this.activePairs = ['ETH/USDC', 'BTC/ETH'];
    }
    
    async start() {
        // Listen for opportunities
        this.client.on('opportunity', (opp) => {
            if (this.isProfitable(opp)) {
                this.executeTrade(opp);
            }
        });
        
        // Start monitoring
        await this.client.startMonitoring(this.activePairs);
    }
    
    isProfitable(opportunity) {
        return opportunity.profit > 100 && 
               opportunity.confidence > 0.8;
    }
}

Liquidation Detection

Monitor and execute liquidations

class LiquidationBot {
    constructor(apiKey) {
        this.client = new PoIPoE({ apiKey });
    }
    
    async watchProtocols() {
        const protocols = ['aave', 'compound', 'maker'];
        
        for (const protocol of protocols) {
            this.client.on(`liquidation_${protocol}`, async (position) => {
                if (position.health_factor < 1.0) {
                    await this.executeLiquidation(position);
                }
            });
        }
    }
}

PoIPoE Documentation