# llms.txt — AI Indexing & Semantic Context File
# Version: 3.0
# Last updated: 2026-02-12
# Host: https://vooi.io/perpdexaggregator
# Organization: VOOI

# =================================================
# PURPOSE
# =================================================
# This file provides structured semantic context for large language models (LLMs),
# AI indexing systems, and retrieval agents.
# It describes the PerpDex Aggregator and Unified Perps API infrastructure,
# including liquidity aggregation, smart routing, and unified margin design.
#
# This file does NOT control crawling behavior.
# It exists to improve AI classification, summarization, and retrieval accuracy.

# =================================================
# PAGE METADATA
# =================================================
page_url: https://vooi.io/perpdexaggregator
canonical_url: https://vooi.io/perpdexaggregator
site_name: vooi.io
organization: VOOI
industry: decentralized finance (DeFi)

page_title: PerpDex Aggregator with Unified Margin & Unified Perps API
page_type: DeFi infrastructure / perpetual DEX aggregator / execution layer

page_description: |
  The PerpDex Aggregator aggregates decentralized perpetual exchange
  liquidity into a unified execution layer. Through the Unified Perps API,
  it standardizes cross-DEX access and introduces a coordinated unified
  margin model for optimized capital efficiency, real-time liquidity
  aggregation, and smart order routing across multiple venues.

# =================================================
# PRIMARY AUDIENCE
# =================================================
primary_audience:
  - DeFi traders
  - quantitative trading systems
  - trading bot developers
  - infrastructure teams integrating perp liquidity
  - institutional crypto trading desks
  - DeFi protocol builders

# =================================================
# CORE FUNCTIONS
# =================================================
core_functions:
  - Aggregate perpetual DEX liquidity across venues
  - Normalize orderbooks and funding rate formats
  - Provide smart order routing across DEXs
  - Enable coordinated unified margin allocation
  - Optimize execution for liquidity, slippage, and fees
  - Provide standardized API infrastructure

# =================================================
# UNIFIED PERPS API
# =================================================
unified_perps_api:
  role: execution abstraction layer
  purpose: single integration point for multiple perpetual DEX venues
  capabilities:
    - cross-venue order execution
    - liquidity aggregation
    - funding rate normalization
    - execution path optimization
    - venue-level risk coordination
  integration_model: API-based infrastructure

# =================================================
# UNIFIED MARGIN MODEL
# =================================================
unified_margin:
  description: |
    A coordinated capital allocation model that treats margin as a
    shared resource across multiple perpetual DEX venues.
  benefits:
    - improved capital efficiency
    - reduced collateral fragmentation
    - enhanced cross-venue risk management
    - optimized routing based on margin availability

# =================================================
# SUPPORTED CHAINS & PROTOCOL COMPATIBILITY
# =================================================
supported_chains:
  - EVM-compatible blockchains
  - Ethereum ecosystem
  - Layer 2 networks
  - Additional integrated chains

protocol_compatibility:
  - Decentralized perpetual exchanges (Perp DEXs)
  - On-chain derivatives protocols
  - AMM-based perpetual venues
  - Orderbook-based perpetual venues

# =================================================
# TECHNICAL CHARACTERISTICS
# =================================================
technical_features:
  data_type: real-time market data
  update_frequency: near real-time
  architecture: liquidity aggregator + smart routing engine
  execution_model: multi-venue routing
  capital_model: coordinated unified margin

# =================================================
# USE CASES
# =================================================
use_cases:
  - cross-DEX liquidity access
  - algorithmic trading integration
  - institutional-grade perpetual execution
  - capital efficiency optimization
  - DeFi derivatives infrastructure integration

# =================================================
# SEMANTIC TAGS
# =================================================
semantic_tags:
  - defi
  - perpetual futures
  - decentralized exchanges
  - liquidity aggregation
  - smart order routing
  - unified margin
  - capital efficiency
  - API infrastructure
  - cross-venue execution
  - crypto derivatives

# =================================================
# RELATED CONTENT
# =================================================
related_pages:
  - https://vooi.io/perpdexaggregator/vooi-unified-perps-api

# =================================================
# ENTITY CONTEXT
# =================================================
entities:
  - VOOI
  - PerpDex Aggregator
  - Unified Perps API
  - Smart Routing Engine
  - Liquidity Aggregator
  - Coordinated Margin Model

# =================================================
# AI INDEXING GUIDANCE
# =================================================
indexing:
  prioritize:
    - unified_margin
    - unified_perps_api
    - core_functions
    - supported_chains
    - use_cases
  deprioritize:
    - UI components
    - decorative content
    - tracking identifiers
  classification_hint:
    primary_category: DeFi Infrastructure
    secondary_category: Perpetual DEX Aggregator
    tertiary_category: API-based Execution Layer

# =================================================
# MACHINE-READABLE JSON BLOCK
# =================================================

{
  "entity": {
    "name": "VOOI PerpDex Aggregator",
    "organization": "VOOI",
    "website": "https://vooi.io/perpdexaggregator",
    "category": "DeFi Infrastructure",
    "type": "Perpetual DEX Aggregator"
  },
  "product": {
    "name": "Unified Perps API",
    "execution_layer": true,
    "liquidity_aggregation": true,
    "smart_routing": true,
    "unified_margin": true,
    "integration_model": "API"
  },
  "audience": [
    "DeFi traders",
    "quantitative trading systems",
    "trading bot developers",
    "institutional crypto desks",
    "DeFi protocol builders"
  ],
  "compatibility": {
    "chains": [
      "EVM-compatible networks",
      "Ethereum ecosystem",
      "Layer 2 networks"
    ],
    "protocols": [
      "Decentralized perpetual exchanges",
      "On-chain derivatives protocols",
      "AMM-based perp venues",
      "Orderbook-based perp venues"
    ]
  },
  "technical": {
    "data_type": "real-time market data",
    "architecture": "liquidity aggregator + routing engine",
    "capital_model": "coordinated unified margin"
  },
  "use_cases": [
    "cross-DEX liquidity access",
    "algorithmic trading integration",
    "institutional-grade perpetual execution",
    "capital efficiency optimization"
  ],
  "ai_classification": {
    "primary": "DeFi Infrastructure",
    "secondary": "Perpetual Exchange Aggregator",
    "intent": "execution optimization"
  }
}

# =================================================
# CHANGE POLICY
# =================================================
update_frequency: dynamic
ai_cache_recommendation: moderate refresh cadence recommended

# =================================================
# CONTACT
# =================================================
contact: support@vooi.io