---
title: AirMicroDrip
emoji: 💧
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
---

# AirMicroDrip

Perpetual Airdrop with LLM Liquidity Perpetual Futures - No Mocks, No Simulations.

## Overview

AirMicroDrip is a revolutionary system that:
1. **Collects slippage** from whale DEX trades on Solana
2. **Distributes collected tokens** to new holders (perpetual airdrop)
3. **Converts LLM inference capacity** into synthetic liquidity
4. **Powers a perpetual futures DEX** with that liquidity
5. **Rewards LLM providers** for their contribution

## Systems

- **Slippage Collector**: Monitors Raydium, Orca, Jupiter for whale trades
- **Holder Tracker**: Detects new token holders and eligibility
- **LLM Liquidity Provider**: Converts inference capacity to synthetic liquidity
- **Perpetual Futures Trading Engine**: Up to 100x leverage trading
- **Funding Rate Engine**: Real-time funding rate calculation
- **Liquidation System**: Position monitoring and liquidation
- **Mining Rewards**: LLM provider rewards and leaderboard

## API Endpoints

- `/health` - System health check
- `/api/overview` - Aggregate statistics from all systems
- `/api/slippage/stats` - Slippage collection statistics
- `/api/holders/stats` - Holder statistics
- `/api/liquidity/stats` - LLM liquidity statistics
- `/api/trading/stats` - Trading statistics
- `/api/funding/stats` - Funding rate statistics
- `/api/liquidation/stats` - Liquidation statistics
- `/api/mining/stats` - Mining rewards statistics
- `/api/token-launch/status` - Latest one-tree Merkle token launch manifest
- `/api/token-launch/prepare` - Prepare a new unsigned Merkle launch manifest
- `/api/token-launch/pool-setup` - Unsigned SPL mint and liquidity-pool setup plan
- `/api/collateral/scan` - Background scan of the Space owner's public HF repos, Spaces, files, and readable LOC
- `/api/collateral/status` - Latest HF account collateral evidence and root

## Tech Stack

- Python 3.10+
- Flask + Gunicorn
- SQLite (real on-disk persistence)
- **Real external APIs only** — no mocks, no simulations

## Real Data Sources

| System | Data Source | Endpoint |
|--------|-------------|----------|
| Trading Prices | Gate.io Futures API | `api.gateio.ws/api/v4/futures/usdt/tickers` |
| Funding Rates | Gate.io Futures API | `api.gateio.ws/api/v4/futures/usdt/funding_rate` |
| Slippage/Volume | DexScreener API | `api.dexscreener.com/latest/dex/tokens/{mint}` |
| Token Holders | Solana JSON-RPC | `getTokenLargestAccounts` |
| Token Transfers | Solana JSON-RPC | `getSignaturesForAddress` + `getTransaction` |
| LLM Benchmark | Real HTTP inference | Ollama or OpenAI-compatible API |
| Token Launch | Local Merkle manifest | one root over token spec, pool spec, allocations, gates, metrics |
| HF Collateral | Hugging Face public repos | repo/file inventory, readable LOC, file hashes |

## Runtime Configuration

The deployed app runs without API keys or required runtime variables. These settings are optional overrides only:

| Variable | Required | Description |
|----------|----------|-------------|
| `TOKEN_MINT` | No | Override the public default Solana token mint |
| `INFERENCE_API_URL` | No | Optional no-key local/Ollama-compatible endpoint for live LLM benchmarking |
| `SOLANA_RPC_URL` | No | Override the public Solana RPC endpoint |

Without overrides, the dashboard still boots with public market data, a public Solana RPC default, local SQLite ledgers, and a local-only LLM liquidity state.

## Deployment

```bash
cd airmicrodrip
export HF_TOKEN=your_token
bash deploy.sh
```

Or see `DEPLOY.md` for detailed instructions.

## No Mock Guarantee

Every data point comes from a real external API call:
- Gate.io for market data (no fake prices)
- DexScreener for DEX volume (no fake volume)
- Solana RPC for on-chain data (no fake holders)
- Real HTTP inference for LLM benchmarks (no fake capacity)
- Merkle token launch manifests are unsigned until real wallet-signed mint/pool transactions exist
- HF collateral reads public repo files and records unreadable files explicitly
- If a source is unavailable, the system returns `waiting`, `local_only`, or `error` states — never invented data.