# Remora On-Chain Intelligence API & Infrastructure
> Sub-24ms mempool streaming, Victor 2020 multi-wallet clustering, and AMM order flow toxicity metrics for institutional desks, autonomous AI agents, and algorithmic quants on Base & EVM networks.

## Overview
Remora (https://remoradata.com) is a high-throughput on-chain intelligence and mempool surveillance platform. It runs sovereign validator nodes and bare-metal P2P gossip peer connections across Frankfurt, Tokyo, and Virginia to detect large transfers, DEX liquidity drain, and toxic flow before block finalization.

## For Autonomous AI Agents & LLMs
AI agents can consume Remora's programmatic endpoints to analyze on-chain activity, monitor whale addresses, calculate slippage/arbitrage paths, and verify contract security without human intervention.

### Base URLs
- Production REST API: `https://remoradata.com/api/v1`
- Production WebSocket Stream: `wss://remoradata.com/ws/v1`
- OpenAPI Specification (JSON): `https://remoradata.com/api/v1/openapi.json`
- Interactive Swagger / Scalar Documentation: `https://remoradata.com/api/v1/docs`

### Authentication
- Pass API key in HTTP header: `X-API-KEY: remora_live_...` or `Authorization: Bearer remora_live_...`
- Unauthenticated requests can query public telemetry, benchmarks, and free developer tier sandbox limits.

### Core Endpoints
- `GET /api/v1/whales/feed?limit=20&minUsd=50000`: Real-time stream of detected whale orders, labeled entities, and execution intent (ACCUMULATION, DUMP, ARBITRAGE).
- `GET /api/v1/whales/:hash`: Deep forensic breakdown of a transaction hash including internal transfer routing and latency telemetry.
- `GET /api/v1/clusters/:address`: Victor 2020 multi-wallet cluster heuristic resolving syndicate addresses, co-spending links, and total aggregated balance.
- `GET /api/v1/microstructure/vpin?pair=ETH-USDC`: Volume-Synchronized Probability of Toxicity (VPIN) and Loss-Versus-Rebalancing (LVR) estimates.
- `GET /api/v1/tokens/search?q=TOKEN_SYMBOL`: Fast token discovery, pair liquidity depth, and 24h volume.
- `GET /api/v1/health`: System status, active RPC peer count, average block propagation latency.

### Supported Chains
- Base Mainnet (Chain ID: 8453) - Primary low-latency hub
- Ethereum Mainnet (Chain ID: 1)
- Arbitrum One (Chain ID: 42161)
- Polygon PoS (Chain ID: 137)
- BNB Smart Chain (Chain ID: 56)

### Legal, Privacy & Compliance
- General Data Protection Regulation (GDPR / RGPD UE 2016/679) & CNIL French regulatory compliance.
- Non-Custodial Architecture: Remora never holds user funds or raw private keys.
- Zero-Ad-Tracker Policy: Zero commercial profiling or third-party advertising pixels.
- Privacy Policy: https://remoradata.com/privacy
- Terms of Service: https://remoradata.com/terms
- Cookie Policy: https://remoradata.com/cookies
- Refund Policy: https://remoradata.com/refund
- Legal Notice (Loi LCEN): https://remoradata.com/legal
- Data Minimization Charter: https://remoradata.com/data-minimization

### Publisher & Contact
- Entity: Remora Technologies SAS, Paris, France
- Hosted in: European Union (Hetzner Online GmbH, ISO 27001)
- DPO Contact: dpo@remoradata.com
- API & Agent Integration Desk: desk@remoradata.com