> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metengine.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Money Intelligence for Your AI Agent

> 74 real-time analytics endpoints across Polymarket, Hyperliquid, and Meteora. Pay per query with USDC -- no API keys, no accounts.

Your AI agent can now read DeFi markets. Track profitable wallets, detect insider patterns, and analyze capital flows across Polymarket, Hyperliquid, and Meteora with a single API.

Pay per query with USDC. No API keys, no accounts, no onboarding. Three payment protocols supported -- pick the one that fits your stack.

## See It in Action

Watch the Data Agent answer real queries across all three platforms.

<Tabs>
  <Tab title="Polymarket">
    <Frame>
      <video controls playsInline className="w-full rounded-xl" src="https://metengine-pnl-cards.s3.eu-central-1.amazonaws.com/agent/final-poly.mp4" />
    </Frame>
  </Tab>

  <Tab title="Hyperliquid">
    <Frame>
      <video controls playsInline className="w-full rounded-xl" src="https://metengine-pnl-cards.s3.eu-central-1.amazonaws.com/agent/hl-new.mp4" />
    </Frame>
  </Tab>

  <Tab title="Meteora">
    <Frame>
      <video controls playsInline className="w-full rounded-xl" src="https://metengine-pnl-cards.s3.eu-central-1.amazonaws.com/agent/meteora-demo.mp4" />
    </Frame>
  </Tab>
</Tabs>

## What You'll Access

<CardGroup cols={3}>
  <Card title="Polymarket" icon="chart-pie">
    38 endpoints. Trending markets, smart money consensus, insider detection, wallet profiling, alpha caller tracking, and capital flow analysis.
  </Card>

  <Card title="Hyperliquid" icon="arrow-trend-up">
    18 endpoints. Trader leaderboards, daily PnL, fresh whale detection, long/short pressure, and smart wallet signals.
  </Card>

  <Card title="Meteora" icon="droplet">
    18 endpoints. Pool trending, LP rankings, volume heatmaps, fee analysis, DCA accumulation pressure, and position tracking.
  </Card>
</CardGroup>

## How Payment Works

Every paid request follows the same settle-after-execute pattern, regardless of which protocol you use.

<Steps>
  <Step title="Request Data">
    Call any endpoint. The server responds with HTTP 402 and the exact USDC price, along with payment instructions for all supported protocols.
  </Step>

  <Step title="Sign Payment Locally">
    Your agent signs a USDC transfer transaction with your wallet. The transaction is **not broadcast** -- it stays local as proof of payment intent.
  </Step>

  <Step title="Re-send With Payment">
    Attach the signed transaction and re-send the same request. The server validates the transaction, runs your query, and only then broadcasts the payment on-chain.
  </Step>

  <Step title="Get Your Data">
    On success, you receive your data plus an on-chain settlement receipt. If the query fails, times out, or returns empty results, the transaction is discarded and you are never charged.
  </Step>
</Steps>

<Tip>Failed queries cost nothing. Timeouts, server errors, and empty results are never settled. You only pay when you get data.</Tip>

### Three Payment Protocols

| Protocol       | Chain       | Currency | SDK                        | Best For                                        |
| -------------- | ----------- | -------- | -------------------------- | ----------------------------------------------- |
| **x402**       | Solana      | USDC     | `@x402/core` + `@x402/svm` | Most users -- established, broad wallet support |
| **MPP Tempo**  | Tempo (EVM) | USDC.e   | `mppx`                     | EVM-native agents with USDC.e on Tempo          |
| **MPP Solana** | Solana      | USDC     | `@solana/mpp`              | MPP-native agents with Solana wallets           |

All three deliver the same data at the same price. The 402 response includes payment challenges for every available protocol -- your client picks whichever it supports.

## Pricing

| Tier   | Base Cost | Typical Endpoints                           |
| ------ | --------- | ------------------------------------------- |
| Light  | \$0.01    | Search, trades feed, platform stats         |
| Medium | \$0.02    | Trending, volume heatmaps, activity feeds   |
| Heavy  | \$0.05    | Leaderboards, scoring, insider detection    |
| Whale  | \$0.08    | Multi-wallet comparisons, opportunity scans |

Multipliers apply for longer timeframes and higher result limits.

<Tip>Check live pricing anytime: `GET https://agent.metengine.xyz/api/v1/pricing` (free, no payment required).</Tip>

## What This API Covers (and What It Doesn't)

This is **read-only analytics**. You get smart money intelligence, wallet scoring, and market signals across three platforms. No trade execution.

## Get Started

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/data-agent/getting-started">
    Set up payments and make your first query in minutes. Covers x402, MPP Tempo, and MPP Solana.
  </Card>

  <Card title="All 74 Endpoints" icon="list" href="/data-agent/endpoints">
    Browse every endpoint with pricing, parameters, and known quirks.
  </Card>
</CardGroup>

## Full Specification

The complete skill spec with every endpoint, parameter, fallback strategy, and integration pattern lives at:

<Card title="skill.md" icon="file-code" href="https://www.metengine.xyz/skill.md">
  Full technical specification for agent integration
</Card>