Back to Details

metengine-data-agent

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

MetEngine Data Agent API

MetEngine 数据Agent API

Real-time smart money analytics across Polymarket, Hyperliquid, and Meteora. 63 endpoints covering wallet scoring, insider detection, capital flow tracking, and position analysis. Pay per request with USDC on Solana -- no API keys, no accounts, no onboarding friction.
覆盖Polymarket、Hyperliquid和Meteora的实时聪明钱分析能力。63个接口涵盖钱包评分、内幕交易检测、资金流追踪和持仓分析功能。基于Solana USDC按请求付费——无需API密钥、无需注册账号、无接入门槛。

Display Rules

展示规则

  • NEVER truncate or trim wallet/contract addresses. Always show full addresses (e.g. 
    0x61276aba49117fd9299707d5d573652949d5c977
    , not 
    0x6127...c977
    ).
  • This applies to all Polymarket (0x hex), Hyperliquid (0x hex), Meteora (base58), condition_ids, token_ids, pool addresses, position addresses, and transaction hashes.
  • 永远不要截断钱包/合约地址，始终展示完整地址（例如 
    0x61276aba49117fd9299707d5d573652949d5c977
    ，而非 
    0x6127...c977
    ）。
  • 该规则适用于所有Polymarket（0x十六进制格式）、Hyperliquid（0x十六进制格式）、Meteora（base58格式）的地址、condition_ids、token_ids、资金池地址、持仓地址以及交易哈希。

Skill Auto-Update

Skill 自动更新

This skill file may change as new endpoints are added or pricing updates. Keep it fresh by downloading the latest version weekly.
Download the latest skill file:
bash
curl -sL https://www.metengine.xyz/skill.md -o ~/.claude/agents/metengine-data-agent.md
Automate weekly updates (cron):
bash
undefined
新增接口或价格调整时，本skill文件可能会发生变更。建议每周下载最新版本保持更新。
下载最新skill文件：
bash
curl -sL https://www.metengine.xyz/skill.md -o ~/.claude/agents/metengine-data-agent.md
自动化每周更新（cron）：
bash
undefined

Add to crontab: crontab -e

加入crontab：执行crontab -e

0 0 * * 0 curl -sL https://www.metengine.xyz/skill.md -o ~/.claude/agents/metengine-data-agent.md 2>/dev/null

**Check skill version before querying (optional):**
```bash
0 0 * * 0 curl -sL https://www.metengine.xyz/skill.md -o ~/.claude/agents/metengine-data-agent.md 2>/dev/null

**查询前检查skill版本（可选）：**
```bash

Compare local vs remote version

对比本地和远程版本

LOCAL_VER=$(grep '^version:' ~/.claude/agents/metengine-data-agent.md | head -1 | tr -d '"' | awk '{print $2}') REMOTE_VER=$(curl -sL https://www.metengine.xyz/skill.md | grep '^version:' | head -1 | tr -d '"' | awk '{print $2}') [ "$LOCAL_VER" != "$REMOTE_VER" ] && curl -sL https://www.metengine.xyz/skill.md -o ~/.claude/agents/metengine-data-agent.md

Agents SHOULD check for updates at the start of a new session if more than 7 days have passed since the last update.

---
LOCAL_VER=$(grep '^version:' ~/.claude/agents/metengine-data-agent.md | head -1 | tr -d '"' | awk '{print $2}') REMOTE_VER=$(curl -sL https://www.metengine.xyz/skill.md | grep '^version:' | head -1 | tr -d '"' | awk '{print $2}') [ "$LOCAL_VER" != "$REMOTE_VER" ] && curl -sL https://www.metengine.xyz/skill.md -o ~/.claude/agents/metengine-data-agent.md

如果距离上次更新超过7天，Agent应该在新会话开始时检查更新。

---

Session Memory (CRITICAL -- Read This First)

会话存储（关键内容 -- 请优先阅读）

Before making ANY API call, check for a memory file at:
~/.claude/agents/metengine-memory.md
This file persists across sessions and stores everything needed to skip setup and make faster queries. If the memory file exists, read it first. It will tell you:
  1. Wallet configuration -- path to the Solana keypair, public address, whether SOL/USDC balances were verified
  2. Package status -- whether 
    @x402/core
    , 
    @x402/svm
    , 
    @solana/kit
    are already installed and where
  3. Client bootstrap -- a working code snippet from the last successful query (copy-paste ready)
  4. Endpoint learnings -- which endpoints worked, which timed out, which fallbacks were used
  5. Pricing cache -- last-fetched pricing schedule (avoids re-reading the full pricing section)
发起任何API调用前，请先检查以下路径的存储文件：
~/.claude/agents/metengine-memory.md
该文件跨会话持久化存储所有可跳过配置、加速查询所需的信息。如果存储文件存在，请优先读取，它会提供以下信息：
  1. 钱包配置 -- Solana密钥对路径、公开地址、SOL/USDC余额是否已验证
  2. 依赖包状态 -- 
    @x402/core
    、
    @x402/svm
    、
    @solana/kit
    是否已安装以及安装路径
  3. 客户端启动代码 -- 上次成功查询可用的代码片段（可直接复制使用）
  4. 接口使用经验 -- 哪些接口可用、哪些超时、使用过哪些降级方案
  5. 定价缓存 -- 上次获取的定价规则（避免重复读取完整定价章节）

Memory File Format

存储文件格式

Create or update 
~/.claude/agents/metengine-memory.md
using this template:
markdown
undefined
使用以下模板创建或更新
~/.claude/agents/metengine-memory.md
：
markdown
undefined

MetEngine Session Memory

MetEngine 会话存储

<!-- Auto-maintained by agents. Do not delete. -->
<!-- 由Agent自动维护，请勿删除 -->

Last Updated

上次更新

YYYY-MM-DD HH:MM UTC
YYYY-MM-DD HH:MM UTC

Skill Version

Skill版本

<version from frontmatter>
<来自前言的版本号>

Wallet

钱包

  • keypair_path: ~/.config/solana/id.json
  • public_address: <base58 pubkey -- NEVER store the private key>
  • sol_balance_ok: true/false
  • usdc_balance_ok: true/false
  • last_balance_check: YYYY-MM-DD
  • keypair_path: ~/.config/solana/id.json
  • public_address: <base58公钥 -- 永远不要存储私钥>
  • sol_balance_ok: true/false
  • usdc_balance_ok: true/false
  • last_balance_check: YYYY-MM-DD

Packages

依赖包

  • installed: true/false
  • install_dir: <path where bun add was run>
  • packages: @x402/core, @x402/svm, @solana/kit
  • bun_version: <version>
  • installed: true/false
  • install_dir: <bun add命令执行的路径>
  • packages: @x402/core, @x402/svm, @solana/kit
  • bun_version: <版本号>

Client Bootstrap

客户端启动代码

<!-- Paste the minimal working paidFetch setup here after first successful call -->
typescript
// <paste the one-time setup + paidFetch function that worked>
<!-- 首次调用成功后粘贴最小可用的paidFetch配置代码 -->
typescript
// <粘贴可用的一次性配置 + paidFetch函数>

Endpoint History

接口调用历史

<!-- Append after each session. Keep the last 10 entries. -->
DateEndpointStatusLatencyUSDC CostNotes
<!-- 每次会话后追加记录，保留最近10条 -->
DateEndpointStatusLatencyUSDC CostNotes

Fallbacks Learned

已验证的降级方案

<!-- Record which fallbacks were needed -->
EndpointIssueFallback Used
<!-- 记录需要使用的降级方案 -->
EndpointIssueFallback Used

Quirks Encountered

遇到的特殊问题

<!-- Record runtime surprises so future sessions avoid them --> 
undefined
<!-- 记录运行时意外问题，供后续会话规避 --> 
undefined

Memory Update Rules

存储更新规则

Agents MUST update the memory file:
  1. After first successful setup -- Record wallet path, public address, installed packages, working bootstrap code
  2. After every API call -- Append to Endpoint History (keep last 10 rows, prune older)
  3. When a fallback is used -- Record in Fallbacks Learned
  4. When a new quirk is discovered -- Record in Quirks Encountered
  5. At session end -- Update 
    Last Updated
    timestamp
Agent必须更新存储文件的场景：
  1. 首次配置成功后 -- 记录钱包路径、公开地址、已安装依赖、可用的启动代码
  2. 每次API调用后 -- 追加到接口调用历史（保留最近10条，删除更早的记录）
  3. 使用降级方案时 -- 记录到已验证的降级方案
  4. 发现新的特殊问题时 -- 记录到遇到的特殊问题
  5. 会话结束时 -- 更新
    上次更新
    时间戳

How Memory Saves Tokens

存储节省Token的效果

Without MemoryWith MemoryToken Savings
Read full skill file (2400 lines) to find setup instructionsSkip to Client Bootstrap section~80% fewer setup tokens
Trial-and-error wallet detectionRead wallet path from memory~500 tokens saved
Install packages every sessionCheck 
installed: true
, skip		~200 tokens saved
Hit known-broken endpoint, get 504, try fallbackCheck Fallbacks Learned, use fallback directly~1000 tokens saved per avoided failure
Re-discover quirks through errorsCheck Quirks Encountered~300 tokens saved per quirk
不使用存储使用存储Token节省比例
读取完整skill文件（2400行）查找配置说明直接跳转到客户端启动代码章节配置阶段减少约80%Token消耗
反复试错检测钱包配置从存储中读取钱包路径节省约500Token
每次会话都安装依赖包检查
installed: true
直接跳过		节省约200Token
调用已知故障接口得到504错误后再试降级方案检查已验证的降级方案直接使用降级接口每次避免失败可节省约1000Token
通过报错重新发现特殊问题检查遇到的特殊问题直接规避每个已知问题节省约300Token

Quick Start for Returning Agents

返回Agent快速开始指南

If 
~/.claude/agents/metengine-memory.md
exists:
1. Read memory file
2. If wallet and packages are set up:
   a. Copy the Client Bootstrap code
   b. Check Fallbacks Learned for the endpoint you need
   c. Make the API call directly
   d. Update Endpoint History
3. If wallet or packages NOT set up:
   a. Follow the Onboarding Path below
   b. Update memory file after setup
First-time agents: Follow the Onboarding Path below, then create the memory file.
如果
~/.claude/agents/metengine-memory.md
存在：
1. 读取存储文件
2. 如果钱包和依赖包已配置：
   a. 复制客户端启动代码
   b. 检查所需接口的已验证降级方案
   c. 直接发起API调用
   d. 更新接口调用历史
3. 如果钱包或依赖包未配置：
   a. 按照下方接入流程操作
   b. 配置完成后更新存储文件
首次使用的Agent： 按照下方接入流程操作，完成后创建存储文件。

Wallet Security Rules

钱包安全规则

  • NEVER read, log, print, or display the contents of any keypair file
  • NEVER store private keys in the memory file
  • ONLY store the file path and the public address
  • Load the keypair at runtime using 
    Bun.file(path).text()
    or 
    fs.readFileSync(path)
    -- pipe directly into the signer, never into a variable that gets logged
  • 永远不要 读取、日志、打印或展示任何密钥对文件的内容
  • 永远不要 在存储文件中存储私钥
  • 仅 存储文件路径和公开地址
  • 运行时使用
    Bun.file(path).text()
    或
    fs.readFileSync(path)
    加载密钥对——直接传入签名器，不要存储到会被日志记录的变量中

Onboarding Path

接入流程

Two steps from zero to data:
Step 1: Verify service is live (free)
GET https://agent.metengine.xyz/health
Step 2: Make a paid request
GET https://agent.metengine.xyz/api/v1/markets/trending?timeframe=24h&limit=5
First call returns 
402
with price. Sign payment. Re-send with 
PAYMENT-SIGNATURE
header. Receive 
200
with data + settlement proof.
Prerequisites: A Solana wallet with SOL (for tx fees) and USDC (for payments). Install 
@x402/core
, 
@x402/svm
, 
@solana/kit
.
从零到获取数据仅需两步：
步骤1：验证服务可用性（免费）
GET https://agent.metengine.xyz/health
步骤2：发起付费请求
GET https://agent.metengine.xyz/api/v1/markets/trending?timeframe=24h&limit=5
首次调用会返回带定价信息的
402
状态码，签名支付后在请求头携带
PAYMENT-SIGNATURE
重新发起请求，即可得到带结算证明的
200
响应和数据。
前置要求：持有SOL（支付交易手续费）和USDC（支付接口费用）的Solana钱包，已安装
@x402/core
、
@x402/svm
、
@solana/kit
。

Payment Protocol: x402 on Solana Mainnet

支付协议：Solana主网x402协议

Every paid endpoint uses a two-step handshake. No API keys. No accounts. Payment IS authentication.
所有付费接口采用两步握手机制，无需API密钥、无需账号，支付即身份验证。

Flow

流程

Agent                          MetEngine                      Solana
  |                               |                             |
  |-- GET /api/v1/endpoint ------>|                             |
  |<-- 402 + PaymentRequired -----|                             |
  |                               |                             |
  |   [sign payment locally]      |                             |
  |                               |                             |
  |-- GET + PAYMENT-SIGNATURE --->|                             |
  |                               |-- verify ------------------>|
  |                               |<-- valid -------------------|
  |                               |                             |
  |                               |   [execute query]           |
  |                               |                             |
  |                               |-- settle ------------------>|
  |                               |<-- tx hash -----------------|
  |<-- 200 + data + PAYMENT- -----|                             |
  |    RESPONSE (settlement)      |                             |
Agent                          MetEngine                      Solana
  |                               |                             |
  |-- GET /api/v1/endpoint ------>|                             |
  |<-- 402 + PaymentRequired -----|                             |
  |                               |                             |
  |   [本地签名支付]               |                             |
  |                               |                             |
  |-- GET + PAYMENT-SIGNATURE --->|                             |
  |                               |-- verify ------------------>|
  |                               |<-- valid -------------------|
  |                               |                             |
  |                               |   [执行查询]                 |
  |                               |                             |
  |                               |-- settle ------------------>|
  |                               |<-- tx hash -----------------|
  |<-- 200 + data + PAYMENT- -----|                             |
  |    RESPONSE (settlement)      |                             |

Important: Settle-After-Execute

重要说明：执行后结算

If the query fails (timeout, server error), no payment is settled. The agent keeps their funds. This is enforced server-side. Only successful 
2xx
responses trigger settlement.
如果查询失败（超时、服务器错误），不会进行支付结算，Agent保留资金，该机制由服务端强制保障。只有成功的
2xx
响应才会触发结算。

Headers

请求头

HeaderDirectionDescription
PAYMENT-REQUIRED
Response (402)Encoded payment requirements
X-PAYMENT-REQUIRED
Response (402)Duplicate of above for compatibility
PAYMENT-SIGNATURE
RequestSigned payment payload
X-PAYMENT
RequestAlternate payment header name
PAYMENT-RESPONSE
Response (200)Settlement proof with tx hash
X-PAYMENT-RESPONSE
Response (200)Duplicate of above for compatibility
头名称方向描述
PAYMENT-REQUIRED
响应（402）编码后的支付要求
X-PAYMENT-REQUIRED
响应（402）兼容用的重复支付要求头
PAYMENT-SIGNATURE
请求签名后的支付负载
X-PAYMENT
请求备用支付头名称
PAYMENT-RESPONSE
响应（200）带交易哈希的结算证明
X-PAYMENT-RESPONSE
响应（200）兼容用的重复结算证明头

Client Implementation (TypeScript/Bun)

客户端实现（TypeScript/Bun）

typescript
import { x402Client, x402HTTPClient } from "@x402/core/client";
import { registerExactSvmScheme } from "@x402/svm/exact/client";
import { toClientSvmSigner } from "@x402/svm";
import { getBase58Encoder, createKeyPairSignerFromBytes } from "@solana/kit";
import type { PaymentRequired, SettleResponse } from "@x402/core/types";

// --- One-time setup ---
const bytes = getBase58Encoder().encode(process.env.SOLANA_PRIVATE_KEY!);
const signer = await createKeyPairSignerFromBytes(bytes);
const client = new x402Client();
registerExactSvmScheme(client, { signer: toClientSvmSigner(signer) });
const httpClient = new x402HTTPClient(client);

// --- Reusable paid fetch ---
const BASE_URL = "https://agent.metengine.xyz";

async function paidFetch(
  path: string,
  options?: { method?: string; body?: Record<string, unknown> },
): Promise<{ data: unknown; settlement: SettleResponse; price: number }> {
  const method = options?.method ?? "GET";
  const url = `${BASE_URL}${path}`;
  const fetchOpts: RequestInit = { method };
  if (options?.body) {
    fetchOpts.headers = { "Content-Type": "application/json" };
    fetchOpts.body = JSON.stringify(options.body);
  }

  // Step 1: Get 402 with price
  const initial = await fetch(url, fetchOpts);
  if (initial.status !== 402) throw new Error(`Expected 402, got ${initial.status}`);
  const body = await initial.json();

  // Step 2: Parse payment requirements
  const paymentRequired: PaymentRequired = httpClient.getPaymentRequiredResponse(
    (name) => initial.headers.get(name), body,
  );
  const price = Number(paymentRequired.accepts[0]!.amount);

  // Step 3: Sign payment
  const paymentPayload = await httpClient.createPaymentPayload(paymentRequired);
  const paymentHeaders = httpClient.encodePaymentSignatureHeader(paymentPayload);

  // Step 4: Re-send with payment
  const paid = await fetch(url, {
    ...fetchOpts,
    headers: { ...fetchOpts.headers as Record<string, string>, ...paymentHeaders },
  });
  if (paid.status !== 200) {
    const err = await paid.json();
    throw new Error(`Payment failed (${paid.status}): ${JSON.stringify(err)}`);
  }
  const paidBody = (await paid.json()) as { data: unknown };

  // Step 5: Extract settlement proof
  const settlement = httpClient.getPaymentSettleResponse(
    (name) => paid.headers.get(name),
  );

  return { data: paidBody.data, settlement, price };
}
typescript
import { x402Client, x402HTTPClient } from "@x402/core/client";
import { registerExactSvmScheme } from "@x402/svm/exact/client";
import { toClientSvmSigner } from "@x402/svm";
import { getBase58Encoder, createKeyPairSignerFromBytes } from "@solana/kit";
import type { PaymentRequired, SettleResponse } from "@x402/core/types";

// --- 一次性配置 ---
const bytes = getBase58Encoder().encode(process.env.SOLANA_PRIVATE_KEY!);
const signer = await createKeyPairSignerFromBytes(bytes);
const client = new x402Client();
registerExactSvmScheme(client, { signer: toClientSvmSigner(signer) });
const httpClient = new x402HTTPClient(client);

// --- 可复用的付费请求方法 ---
const BASE_URL = "https://agent.metengine.xyz";

async function paidFetch(
  path: string,
  options?: { method?: string; body?: Record<string, unknown> },
): Promise<{ data: unknown; settlement: SettleResponse; price: number }> {
  const method = options?.method ?? "GET";
  const url = `${BASE_URL}${path}`;
  const fetchOpts: RequestInit = { method };
  if (options?.body) {
    fetchOpts.headers = { "Content-Type": "application/json" };
    fetchOpts.body = JSON.stringify(options.body);
  }

  // 步骤1：获取带定价的402响应
  const initial = await fetch(url, fetchOpts);
  if (initial.status !== 402) throw new Error(`Expected 402, got ${initial.status}`);
  const body = await initial.json();

  // 步骤2：解析支付要求
  const paymentRequired: PaymentRequired = httpClient.getPaymentRequiredResponse(
    (name) => initial.headers.get(name), body,
  );
  const price = Number(paymentRequired.accepts[0]!.amount);

  // 步骤3：签名支付
  const paymentPayload = await httpClient.createPaymentPayload(paymentRequired);
  const paymentHeaders = httpClient.encodePaymentSignatureHeader(paymentPayload);

  // 步骤4：携带支付信息重新发起请求
  const paid = await fetch(url, {
    ...fetchOpts,
    headers: { ...fetchOpts.headers as Record<string, string>, ...paymentHeaders },
  });
  if (paid.status !== 200) {
    const err = await paid.json();
    throw new Error(`Payment failed (${paid.status}): ${JSON.stringify(err)}`);
  }
  const paidBody = (await paid.json()) as { data: unknown };

  // 步骤5：提取结算证明
  const settlement = httpClient.getPaymentSettleResponse(
    (name) => paid.headers.get(name),
  );

  return { data: paidBody.data, settlement, price };
}

Usage Examples

使用示例

typescript
// GET endpoint
const { data, price } = await paidFetch("/api/v1/markets/trending?timeframe=24h&limit=5");
console.log(`Paid $${price} USDC. Got ${(data as any[]).length} markets.`);

// POST endpoint
const { data: intel } = await paidFetch("/api/v1/markets/intelligence", {
  method: "POST",
  body: { condition_id: "0xabc123...", top_n_wallets: 10 },
});
typescript
// GET接口示例
const { data, price } = await paidFetch("/api/v1/markets/trending?timeframe=24h&limit=5");
console.log(`Paid $${price} USDC. Got ${(data as any[]).length} markets.`);

// POST接口示例
const { data: intel } = await paidFetch("/api/v1/markets/intelligence", {
  method: "POST",
  body: { condition_id: "0xabc123...", top_n_wallets: 10 },
});

NPM Dependencies

NPM依赖

bash
bun add @x402/core @x402/svm @solana/kit
bash
bun add @x402/core @x402/svm @solana/kit

Pricing

定价

All prices are in USDC on Solana Mainnet. Pricing is dynamic based on endpoint tier, timeframe, limit, and filter usage.
所有价格以Solana主网USDC计价，定价根据接口层级、时间范围、返回条数和过滤条件动态计算。

Tier Base Costs

层级基础费用

TierBase Cost (USDC)Description
light$0.01Simple lookups, searches, feeds
medium$0.02Aggregated analytics, trending data
heavy$0.05Computed intelligence, leaderboards, scoring
whale$0.08Multi-entity comparisons, complex scans
层级基础费用（USDC）描述
light$0.01简单查询、搜索、信息流
medium$0.02聚合分析、趋势数据
heavy$0.05计算类智能分析、排行榜、评分
whale$0.08多实体对比、复杂扫描

Price Modifiers

价格调整系数

Timeframe multiplier (applied to base cost):
TimeframeMultiplier
1h0.5x
4h0.7x
12h0.9x
24h / today1.0x
7d2.0x
30d3.0x
90d4.0x
365d / all5.0x
Limit multiplier: 
price *= max(1, requested_limit / default_limit)
Filter discounts (reduce scan cost):
FilterDiscountApplicable Endpoints
category0.7xtrending, top-performers, whales, capital-flow, high-conviction, opportunities
condition_id0.5xwhales, sentiment, participants, wallet activity
smart_money_only=true0.7xwhales, capital-flow, volume-heatmap (Polymarket + HL)
coin/coins0.7xHL whales, long-short-ratio, pressure/pairs
pool_type (not "all")0.7xAll Meteora endpoints with pool_type param
pool_address0.5xpool detail, volume-history, events, fee-analysis, positions/active
Special rules:
  • wallets/compare
    : 
    price *= wallets.length / 2
  • hl/traders/compare
    : 
    price *= traders.length / 2
  • meteora/lps/compare
    : 
    price *= owners.length / 2
  • wallets/profile
    : both includes=1.0x, one include=0.7x, neither=0.4x
  • wallets/top-performers
    without category: 2.0x penalty
Hard caps:
  • /api/v1/markets/opportunities
    : max $0.15
  • /api/v1/wallets/copy-traders
    : max $0.12
Global bounds: Floor $0.01, Ceiling $0.20 per request.
时间范围乘数（应用于基础费用）：
时间范围乘数
1h0.5x
4h0.7x
12h0.9x
24h / 当日1.0x
7d2.0x
30d3.0x
90d4.0x
365d / 全部5.0x
返回条数乘数: 
price *= max(1, 请求条数 / 默认条数)
过滤折扣（降低扫描成本）：
过滤条件折扣适用接口
category0.7xtrending, top-performers, whales, capital-flow, high-conviction, opportunities
condition_id0.5xwhales, sentiment, participants, wallet activity
smart_money_only=true0.7xwhales, capital-flow, volume-heatmap (Polymarket + HL)
coin/coins0.7xHL whales, long-short-ratio, pressure/pairs
pool_type (非"all")0.7x所有带pool_type参数的Meteora接口
pool_address0.5xpool detail, volume-history, events, fee-analysis, positions/active
特殊规则：
  • wallets/compare
    : 
    price *= wallets.length / 2
  • hl/traders/compare
    : 
    price *= traders.length / 2
  • meteora/lps/compare
    : 
    price *= owners.length / 2
  • wallets/profile
    : 同时包含两个include参数1.0x，仅包含一个0.7x，都不包含0.4x
  • 未加category过滤的
    wallets/top-performers
    ：2.0x额外费用
价格上限：
  • /api/v1/markets/opportunities
    : 最高$0.15
  • /api/v1/wallets/copy-traders
    : 最高$0.12
全局价格区间: 单次请求最低$0.01，最高$0.20。

Machine-Readable Pricing

机器可读定价接口

GET https://agent.metengine.xyz/api/v1/pricing
Returns the full pricing schedule as JSON including all tiers, routes, multipliers, discounts, and special rules. Free endpoint. No payment required.
GET https://agent.metengine.xyz/api/v1/pricing
返回完整的JSON格式定价规则，包含所有层级、路由、乘数、折扣和特殊规则，免费接口，无需支付。

Capability Manifest

能力清单

Polymarket (27 endpoints)

Polymarket（27个接口）

#MethodPathTierDescription
1GET/api/v1/markets/trendingmediumTrending markets with volume spikes
2GET/api/v1/markets/searchlightSearch markets by keyword, category, status, or Polymarket URL
3GET/api/v1/markets/categorieslightAll categories with activity stats
4GET/api/v1/platform/statslightPlatform-wide aggregate stats
5POST/api/v1/markets/intelligenceheavyFull smart money intelligence report for a market
6GET/api/v1/markets/price-historylightOHLCV price/probability time series
7POST/api/v1/markets/sentimentmediumSentiment time series with smart money overlay
8POST/api/v1/markets/participantsmediumParticipant summary by scoring tier
9POST/api/v1/markets/insidersheavyInsider pattern detection (7-signal behavioral scoring)
10GET/api/v1/markets/tradeslightChronological trade feed for a market
11GET/api/v1/markets/similarwhaleRelated markets by wallet overlap
12GET/api/v1/markets/opportunitieswhaleMarkets where smart money disagrees with price
13GET/api/v1/markets/high-convictionheavyHigh-conviction smart money bets
14GET/api/v1/markets/capital-flowmediumCapital flow by category (sector rotation)
15GET/api/v1/trades/whalesmediumLarge whale trades
16GET/api/v1/markets/volume-heatmapmediumVolume distribution across categories/hours/days
17POST/api/v1/wallets/profileheavyFull wallet dossier with score, positions, trades
18POST/api/v1/wallets/activitymediumRecent trading activity for a wallet
19POST/api/v1/wallets/pnl-breakdownmediumPer-market PnL breakdown
20POST/api/v1/wallets/comparewhaleCompare 2-5 wallets side-by-side
21POST/api/v1/wallets/copy-traderswhaleDetect wallets copying a target wallet
22GET/api/v1/wallets/top-performersheavyLeaderboard by PnL, ROI, Sharpe, win rate, volume
23GET/api/v1/wallets/niche-expertsheavyTop wallets in a specific category
24GET/api/v1/markets/resolutionslightResolved markets with smart money accuracy
25GET/api/v1/wallets/alpha-callersheavyWallets that trade early on later-trending markets
26GET/api/v1/markets/dumb-moneymediumLow-score trader positions (contrarian indicator)
27GET/api/v1/wallets/insidersheavyGlobal insider candidates by behavioral score
序号请求方法路径层级描述
1GET/api/v1/markets/trendingmedium交易量激增的热门市场
2GET/api/v1/markets/searchlight按关键词、分类、状态或Polymarket URL搜索市场
3GET/api/v1/markets/categorieslight所有分类及活跃度统计
4GET/api/v1/platform/statslight平台整体聚合统计
5POST/api/v1/markets/intelligenceheavy单个市场的完整聪明钱分析报告
6GET/api/v1/markets/price-historylightOHLCV价格/概率时间序列
7POST/api/v1/markets/sentimentmedium叠加聪明钱数据的情绪时间序列
8POST/api/v1/markets/participantsmedium按评分层级划分的参与者统计
9POST/api/v1/markets/insidersheavy内幕交易模式检测（7信号行为评分）
10GET/api/v1/markets/tradeslight单个市场的时间序交易流
11GET/api/v1/markets/similarwhale基于钱包重叠度的相关市场
12GET/api/v1/markets/opportunitieswhale聪明钱判断与价格偏离的市场
13GET/api/v1/markets/high-convictionheavy高置信度聪明钱押注
14GET/api/v1/markets/capital-flowmedium按分类统计的资金流（板块轮动）
15GET/api/v1/trades/whalesmedium大额鲸鱼交易
16GET/api/v1/markets/volume-heatmapmedium跨分类/小时/天的交易量分布
17POST/api/v1/wallets/profileheavy完整的钱包档案，包含评分、持仓、交易
18POST/api/v1/wallets/activitymedium单个钱包的近期交易活动
19POST/api/v1/wallets/pnl-breakdownmedium按市场划分的PnL明细
20POST/api/v1/wallets/comparewhale2-5个钱包的横向对比
21POST/api/v1/wallets/copy-traderswhale检测复制目标钱包操作的跟单钱包
22GET/api/v1/wallets/top-performersheavy按PnL、ROI、夏普比率、胜率、交易量排序的排行榜
23GET/api/v1/wallets/niche-expertsheavy特定分类的顶级钱包
24GET/api/v1/markets/resolutionslight已结算市场及聪明钱预测准确率
25GET/api/v1/wallets/alpha-callersheavy提前布局后续热门市场的钱包
26GET/api/v1/markets/dumb-moneymedium低评分交易者持仓（反向指标）
27GET/api/v1/wallets/insidersheavy按行为评分筛选的全局内幕交易候选者

Hyperliquid (18 endpoints)

Hyperliquid（18个接口）

#MethodPathTierDescription
28GET/api/v1/hl/platform/statslightPlatform aggregate stats
29GET/api/v1/hl/coins/trendingmediumTrending coins by activity
30GET/api/v1/hl/coins/listlightAll traded coins with 7d stats
31GET/api/v1/hl/coins/volume-heatmapmediumVolume by coin and hour
32GET/api/v1/hl/traders/leaderboardheavyRanked trader leaderboard
33POST/api/v1/hl/traders/profileheavyFull trader dossier
34POST/api/v1/hl/traders/comparewhaleCompare 2-5 traders
35GET/api/v1/hl/traders/daily-pnlmediumDaily PnL time series with streaks
36POST/api/v1/hl/traders/pnl-by-coinmediumPer-coin PnL breakdown (closed PnL only)
37GET/api/v1/hl/traders/fresh-whalesheavyNew high-volume wallets
38GET/api/v1/hl/trades/whalesmediumLarge trades
39GET/api/v1/hl/trades/feedlightChronological trade feed for a coin
40GET/api/v1/hl/trades/long-short-ratiomediumLong/short volume ratio time series
41GET/api/v1/hl/smart-wallets/listlightSmart wallet list with scores
42GET/api/v1/hl/smart-wallets/activitymediumSmart wallet recent trades
43GET/api/v1/hl/smart-wallets/signalsheavyAggregated directional signals by coin
44GET/api/v1/hl/pressure/pairsheavyLong/short pressure with smart positions
45GET/api/v1/hl/pressure/summarymediumPressure summary across all coins
序号请求方法路径层级描述
28GET/api/v1/hl/platform/statslight平台聚合统计
29GET/api/v1/hl/coins/trendingmedium按活跃度排序的热门币种
30GET/api/v1/hl/coins/listlight所有交易币种及7天统计
31GET/api/v1/hl/coins/volume-heatmapmedium按币种和小时统计的交易量
32GET/api/v1/hl/traders/leaderboardheavy交易者排行榜
33POST/api/v1/hl/traders/profileheavy完整的交易者档案
34POST/api/v1/hl/traders/comparewhale2-5个交易者的横向对比
35GET/api/v1/hl/traders/daily-pnlmedium带连胜/连败记录的每日PnL时间序列
36POST/api/v1/hl/traders/pnl-by-coinmedium按币种划分的PnL明细（仅已平仓PnL）
37GET/api/v1/hl/traders/fresh-whalesheavy新高交易量钱包（资深交易者新账号、机构账户或内幕交易者）
38GET/api/v1/hl/trades/whalesmedium大额交易
39GET/api/v1/hl/trades/feedlight单个币种的时间序交易流
40GET/api/v1/hl/trades/long-short-ratiomedium多空交易量比时间序列
41GET/api/v1/hl/smart-wallets/listlight带评分的聪明钱包列表
42GET/api/v1/hl/smart-wallets/activitymedium聪明钱包近期交易
43GET/api/v1/hl/smart-wallets/signalsheavy按币种聚合的方向信号
44GET/api/v1/hl/pressure/pairsheavy带聪明钱持仓的多空压力
45GET/api/v1/hl/pressure/summarymedium所有币种的压力汇总

Meteora (18 endpoints)

Meteora（18个接口）

#MethodPathTierDescription
46GET/api/v1/meteora/pools/trendingmediumTrending pools by volume spike
47GET/api/v1/meteora/pools/topmediumTop pools by volume, fees, or LP count
48GET/api/v1/meteora/pools/searchlightSearch pools by address or token name
49GET/api/v1/meteora/pools/detailmediumFull pool detail
50GET/api/v1/meteora/pools/volume-historylightVolume time series
51GET/api/v1/meteora/pools/eventslightChronological event feed
52GET/api/v1/meteora/pools/fee-analysismediumFee claiming analysis
53GET/api/v1/meteora/lps/topheavyTop LPs leaderboard
54POST/api/v1/meteora/lps/profileheavyFull LP dossier
55GET/api/v1/meteora/lps/whalesmediumLarge LP events
56POST/api/v1/meteora/lps/comparewhaleCompare 2-5 LPs
57GET/api/v1/meteora/positions/activemediumActive LP positions
58GET/api/v1/meteora/positions/historylightPosition event history (DLMM only)
59GET/api/v1/meteora/platform/statslightPlatform-wide stats
60GET/api/v1/meteora/platform/volume-heatmapmediumVolume by action/hour
61GET/api/v1/meteora/platform/metengine-sharelightMetEngine routing share
62GET/api/v1/meteora/dca/pressuremediumDCA accumulation pressure by token
63GET/api/v1/meteora/pools/smart-walletheavyPools with highest smart wallet LP activity
序号请求方法路径层级描述
46GET/api/v1/meteora/pools/trendingmedium交易量激增的热门资金池
47GET/api/v1/meteora/pools/topmedium按交易量、手续费、LP数量排序的顶级资金池
48GET/api/v1/meteora/pools/searchlight按地址或代币名称搜索资金池
49GET/api/v1/meteora/pools/detailmedium完整的资金池详情
50GET/api/v1/meteora/pools/volume-historylight交易量时间序列
51GET/api/v1/meteora/pools/eventslight时间序事件流
52GET/api/v1/meteora/pools/fee-analysismedium手续费领取分析
53GET/api/v1/meteora/lps/topheavy顶级LP排行榜
54POST/api/v1/meteora/lps/profileheavy完整的LP档案
55GET/api/v1/meteora/lps/whalesmedium大额LP事件
56POST/api/v1/meteora/lps/comparewhale2-5个LP的横向对比
57GET/api/v1/meteora/positions/activemedium活跃LP持仓
58GET/api/v1/meteora/positions/historylight持仓事件历史（仅DLMM）
59GET/api/v1/meteora/platform/statslight平台整体统计
60GET/api/v1/meteora/platform/volume-heatmapmedium按操作/小时统计的交易量
61GET/api/v1/meteora/platform/metengine-sharelightMetEngine路由占比
62GET/api/v1/meteora/dca/pressuremedium按代币统计的DCA积累压力
63GET/api/v1/meteora/pools/smart-walletheavy聪明钱LP活跃度最高的资金池

Complete Endpoint Reference

完整接口参考

Response Envelope

响应封装

All 
200
responses use the format: 
{ "data": <payload> }
All error responses use: 
{ "error": "<message>" }
with optional 
"reason"
field.
所有
200
响应采用格式：
{ "data": <payload> }
所有错误响应采用格式：
{ "error": "<message>" }
，可选附带
"reason"
字段。

POLYMARKET

POLYMARKET

1. GET /api/v1/markets/trending

1. GET /api/v1/markets/trending

Trending markets with volume spikes.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring24h1h, 4h, 12h, 24h, 7dno
categorystring-any valid categoryno
sort_bystringvolume_spikevolume_spike, trade_count, smart_money_inflowno
limitinteger201-100no
Response schema:
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "period_volume_usdc": "number",
      "period_trade_count": "number",
      "volume_spike_multiplier": "number",
      "smart_money_wallets_active": "number",
      "smart_money_net_direction": "string",
      "buy_sell_ratio": "number",
      "leader_price": "number"
    }
  ]
}
交易量激增的热门市场。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring24h1h, 4h, 12h, 24h, 7d否
categorystring-任意有效分类否
sort_bystringvolume_spikevolume_spike, trade_count, smart_money_inflow否
limitinteger201-100否
响应结构：
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "period_volume_usdc": "number",
      "period_trade_count": "number",
      "volume_spike_multiplier": "number",
      "smart_money_wallets_active": "number",
      "smart_money_net_direction": "string",
      "buy_sell_ratio": "number",
      "leader_price": "number"
    }
  ]
}

2. GET /api/v1/markets/search

2. GET /api/v1/markets/search

Search markets by keyword, category, status. Accepts Polymarket URLs as the 
query
param.
Parameters (query string):
ParamTypeDefaultValuesRequired
querystring-keyword or Polymarket URLno
categorystring-any valid categoryno
statusstringactiveactive, closing_soon, resolvedno
has_smart_money_signalboolean-true, falseno
sort_bystringrelevanceend_date, volume, relevanceno
limitinteger201-100no
Response schema:
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "end_date": "string (ISO 8601)",
      "status": "string",
      "total_volume_usdc": "number",
      "smart_money_outcome": "string | null",
      "smart_money_wallets": "number",
      "has_contrarian_signal": "boolean",
      "leader_price": "number"
    }
  ]
}
按关键词、分类、状态搜索市场，支持将Polymarket URL作为
query
参数传入。
参数（查询字符串）：
参数类型默认值可选值必填
querystring-关键词或Polymarket URL否
categorystring-任意有效分类否
statusstringactiveactive, closing_soon, resolved否
has_smart_money_signalboolean-true, false否
sort_bystringrelevanceend_date, volume, relevance否
limitinteger201-100否
响应结构：
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "end_date": "string (ISO 8601)",
      "status": "string",
      "total_volume_usdc": "number",
      "smart_money_outcome": "string | null",
      "smart_money_wallets": "number",
      "has_contrarian_signal": "boolean",
      "leader_price": "number"
    }
  ]
}

3. GET /api/v1/markets/categories

3. GET /api/v1/markets/categories

List all categories with activity stats.
Parameters (query string):
ParamTypeDefaultValuesRequired
include_statsbooleantruetrue, falseno
timeframestring24h24h, 7dno
Response schema:
json
{
  "data": [
    {
      "name": "string",
      "active_markets": "number",
      "period_volume": "number",
      "period_trades": "number",
      "unique_traders": "number"
    }
  ]
}
列出所有分类及活跃度统计。
参数（查询字符串）：
参数类型默认值可选值必填
include_statsbooleantruetrue, false否
timeframestring24h24h, 7d否
响应结构：
json
{
  "data": [
    {
      "name": "string",
      "active_markets": "number",
      "period_volume": "number",
      "period_trades": "number",
      "unique_traders": "number"
    }
  ]
}

4. GET /api/v1/platform/stats

4. GET /api/v1/platform/stats

Platform-wide aggregate stats.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring24h24h, 7d, 30dno
Response schema:
json
{
  "data": {
    "timeframe": "string",
    "total_volume_usdc": "number",
    "total_trades": "number",
    "active_traders": "number",
    "active_markets": "number",
    "resolved_markets": "number",
    "smart_wallet_count": "number",
    "avg_trade_size_usdc": "number"
  }
}
平台整体聚合统计。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring24h24h, 7d, 30d否
响应结构：
json
{
  "data": {
    "timeframe": "string",
    "total_volume_usdc": "number",
    "total_trades": "number",
    "active_traders": "number",
    "active_markets": "number",
    "resolved_markets": "number",
    "smart_wallet_count": "number",
    "avg_trade_size_usdc": "number"
  }
}

5. POST /api/v1/markets/intelligence

5. POST /api/v1/markets/intelligence

Full smart money intelligence report on a specific market.
Request body (JSON):
FieldTypeDefaultValuesRequired
condition_idstring--yes
top_n_walletsinteger101-50no
Response schema:
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "end_date": "string",
    "outcomes": "object",
    "smart_money": {
      "consensus_outcome": "string",
      "consensus_strength": "number",
      "by_outcome": {
        "<outcome_name>": {
          "wallet_count": "number",
          "total_usdc": "number",
          "percentage": "number",
          "top_wallets": [
            {
              "wallet": "string",
              "score": "number",
              "tags": ["string"],
              "usdc_invested": "number",
              "net_position": "number",
              "avg_buy_price": "number"
            }
          ]
        }
      }
    },
    "dumb_money": {
      "consensus_outcome": "string",
      "contrarian_to_smart": "boolean",
      "by_outcome": "object"
    },
    "signal_analysis": {
      "smart_vs_price_aligned": "boolean",
      "contrarian_signal": "boolean",
      "signal_summary": "string"
    },
    "recent_activity": {
      "volume_24h": "number",
      "trade_count_24h": "number",
      "buy_sell_ratio": "number",
      "volume_trend": "string"
    }
  }
}
特定市场的完整聪明钱分析报告。
请求体（JSON）：
字段类型默认值可选值必填
condition_idstring--是
top_n_walletsinteger101-50否
响应结构：
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "end_date": "string",
    "outcomes": "object",
    "smart_money": {
      "consensus_outcome": "string",
      "consensus_strength": "number",
      "by_outcome": {
        "<outcome_name>": {
          "wallet_count": "number",
          "total_usdc": "number",
          "percentage": "number",
          "top_wallets": [
            {
              "wallet": "string",
              "score": "number",
              "tags": ["string"],
              "usdc_invested": "number",
              "net_position": "number",
              "avg_buy_price": "number"
            }
          ]
        }
      }
    },
    "dumb_money": {
      "consensus_outcome": "string",
      "contrarian_to_smart": "boolean",
      "by_outcome": "object"
    },
    "signal_analysis": {
      "smart_vs_price_aligned": "boolean",
      "contrarian_signal": "boolean",
      "signal_summary": "string"
    },
    "recent_activity": {
      "volume_24h": "number",
      "trade_count_24h": "number",
      "buy_sell_ratio": "number",
      "volume_trend": "string"
    }
  }
}

6. GET /api/v1/markets/price-history

6. GET /api/v1/markets/price-history

OHLCV price/probability time series.
Parameters (query string):
ParamTypeDefaultValuesRequired
condition_idstring--yes
timeframestring7d1h, 4h, 12h, 24h, 7d, 30dno
bucket_sizestring1h5m, 15m, 1h, 4h, 12h, 1dno
Response schema:
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "candles_by_outcome": {
      "<outcome_name>": [
        {
          "bucket": "string (ISO 8601)",
          "token_id": "string",
          "outcome": "string",
          "open": "number",
          "high": "number",
          "low": "number",
          "close": "number",
          "volume": "number",
          "trade_count": "number",
          "vwap": "number"
        }
      ]
    }
  }
}
OHLCV价格/概率时间序列。
参数（查询字符串）：
参数类型默认值可选值必填
condition_idstring--是
timeframestring7d1h, 4h, 12h, 24h, 7d, 30d否
bucket_sizestring1h5m, 15m, 1h, 4h, 12h, 1d否
响应结构：
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "candles_by_outcome": {
      "<outcome_name>": [
        {
          "bucket": "string (ISO 8601)",
          "token_id": "string",
          "outcome": "string",
          "open": "number",
          "high": "number",
          "low": "number",
          "close": "number",
          "volume": "number",
          "trade_count": "number",
          "vwap": "number"
        }
      ]
    }
  }
}

7. POST /api/v1/markets/sentiment

7. POST /api/v1/markets/sentiment

Sentiment time series with smart money overlay.
Request body (JSON):
FieldTypeDefaultValuesRequired
condition_idstring--yes
timeframestring7d24h, 7d, 30dno
bucket_sizestring4h1h, 4h, 12h, 1dno
Response schema:
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "overall_sentiment": "object",
    "by_outcome": "object",
    "time_series": "array",
    "momentum": "object"
  }
}
叠加聪明钱数据的情绪时间序列。
请求体（JSON）：
字段类型默认值可选值必填
condition_idstring--是
timeframestring7d24h, 7d, 30d否
bucket_sizestring4h1h, 4h, 12h, 1d否
响应结构：
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "overall_sentiment": "object",
    "by_outcome": "object",
    "time_series": "array",
    "momentum": "object"
  }
}

8. POST /api/v1/markets/participants

8. POST /api/v1/markets/participants

Participant summary by scoring tier.
Request body (JSON):
FieldTypeDefaultValuesRequired
condition_idstring--yes
Response schema:
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "total_wallets": "number",
    "total_usdc": "number",
    "by_outcome": "object",
    "tier_distribution": "object"
  }
}
按评分层级划分的参与者统计。
请求体（JSON）：
字段类型默认值可选值必填
condition_idstring--是
响应结构：
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "total_wallets": "number",
    "total_usdc": "number",
    "by_outcome": "object",
    "tier_distribution": "object"
  }
}

9. POST /api/v1/markets/insiders

9. POST /api/v1/markets/insiders

Insider pattern detection using 7-signal behavioral scoring.
Request body (JSON):
FieldTypeDefaultValuesRequired
condition_idstring--yes
limitinteger251-100no
min_scoreinteger200-100no
Response schema:
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "insiders": [
      {
        "wallet": "string",
        "insider_score": "number",
        "signals": "object",
        "outcome": "string",
        "net_shares": "number",
        "buy_usdc": "number",
        "wallet_age_days": "number",
        "first_trade_timestamp": "string"
      }
    ],
    "summary": "object"
  }
}
采用7信号行为评分的内幕交易模式检测。
请求体（JSON）：
字段类型默认值可选值必填
condition_idstring--是
limitinteger251-100否
min_scoreinteger200-100否
响应结构：
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "insiders": [
      {
        "wallet": "string",
        "insider_score": "number",
        "signals": "object",
        "outcome": "string",
        "net_shares": "number",
        "buy_usdc": "number",
        "wallet_age_days": "number",
        "first_trade_timestamp": "string"
      }
    ],
    "summary": "object"
  }
}

10. GET /api/v1/markets/trades

10. GET /api/v1/markets/trades

Chronological trade feed for a market.
Parameters (query string):
ParamTypeDefaultValuesRequired
condition_idstring--yes
timeframestring24h1h, 4h, 12h, 24h, 7d, 30dno
sidestring-BUY, SELLno
min_usdcnumber0>= 0no
smart_money_onlybooleanfalsetrue, falseno
limitinteger1001-500no
Response schema:
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "trade_count": "number",
    "total_volume": "number",
    "trades": [
      {
        "tx_hash": "string",
        "wallet": "string",
        "token_id": "string",
        "outcome": "string",
        "side": "string",
        "price": "number",
        "size": "number",
        "usdc_size": "number",
        "timestamp": "string",
        "wallet_score": "number",
        "wallet_tags": ["string"]
      }
    ]
  }
}
单个市场的时间序交易流。
参数（查询字符串）：
参数类型默认值可选值必填
condition_idstring--是
timeframestring24h1h, 4h, 12h, 24h, 7d, 30d否
sidestring-BUY, SELL否
min_usdcnumber0>= 0否
smart_money_onlybooleanfalsetrue, false否
limitinteger1001-500否
响应结构：
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "trade_count": "number",
    "total_volume": "number",
    "trades": [
      {
        "tx_hash": "string",
        "wallet": "string",
        "token_id": "string",
        "outcome": "string",
        "side": "string",
        "price": "number",
        "size": "number",
        "usdc_size": "number",
        "timestamp": "string",
        "wallet_score": "number",
        "wallet_tags": ["string"]
      }
    ]
  }
}

11. GET /api/v1/markets/similar

11. GET /api/v1/markets/similar

Related markets by wallet overlap.
Parameters (query string):
ParamTypeDefaultValuesRequired
condition_idstring--yes
limitinteger101-50no
Response schema:
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "shared_wallet_count": "number",
      "wallet_overlap_pct": "number",
      "total_volume_usdc": "number"
    }
  ]
}
基于钱包重叠度的相关市场。
参数（查询字符串）：
参数类型默认值可选值必填
condition_idstring--是
limitinteger101-50否
响应结构：
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "shared_wallet_count": "number",
      "wallet_overlap_pct": "number",
      "total_volume_usdc": "number"
    }
  ]
}

12. GET /api/v1/markets/opportunities

12. GET /api/v1/markets/opportunities

Markets where smart money disagrees with price.
Parameters (query string):
ParamTypeDefaultValuesRequired
min_signal_strengthstringmoderateweak, moderate, strongno
categorystring-any valid categoryno
closing_within_hoursinteger-max 720no
min_smart_walletsinteger3>= 1no
limitinteger201-100no
Response schema:
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "smart_money_favors": "string",
      "smart_money_percentage": "number",
      "smart_wallet_count": "number",
      "avg_smart_score": "number",
      "price_signal_gap": "number",
      "signal_direction": "string",
      "signal_strength": "string",
      "leader_price": "number",
      "time_until_close": "string"
    }
  ]
}
聪明钱判断与价格偏离的市场。
参数（查询字符串）：
参数类型默认值可选值必填
min_signal_strengthstringmoderateweak, moderate, strong否
categorystring-任意有效分类否
closing_within_hoursinteger-最大720否
min_smart_walletsinteger3>= 1否
limitinteger201-100否
响应结构：
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "smart_money_favors": "string",
      "smart_money_percentage": "number",
      "smart_wallet_count": "number",
      "avg_smart_score": "number",
      "price_signal_gap": "number",
      "signal_direction": "string",
      "signal_strength": "string",
      "leader_price": "number",
      "time_until_close": "string"
    }
  ]
}

13. GET /api/v1/markets/high-conviction

13. GET /api/v1/markets/high-conviction

High-conviction smart money bets.
Parameters (query string):
ParamTypeDefaultValuesRequired
categorystring-any valid categoryno
min_smart_walletsinteger5>= 1no
min_avg_scoreinteger650-100no
limitinteger201-100no
Response schema:
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "smart_wallet_count": "number",
      "avg_smart_score": "number",
      "total_smart_usdc": "number",
      "conviction_score": "number",
      "favored_outcome": "string",
      "favored_outcome_percentage": "number",
      "entry_vs_current_gap": "number"
    }
  ]
}
高置信度聪明钱押注。
参数（查询字符串）：
参数类型默认值可选值必填
categorystring-任意有效分类否
min_smart_walletsinteger5>= 1否
min_avg_scoreinteger650-100否
limitinteger201-100否
响应结构：
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "smart_wallet_count": "number",
      "avg_smart_score": "number",
      "total_smart_usdc": "number",
      "conviction_score": "number",
      "favored_outcome": "string",
      "favored_outcome_percentage": "number",
      "entry_vs_current_gap": "number"
    }
  ]
}

14. GET /api/v1/markets/capital-flow

14. GET /api/v1/markets/capital-flow

Capital flow by category (sector rotation).
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring7d24h, 7d, 30dno
smart_money_onlybooleanfalsetrue, falseno
top_n_categoriesinteger201-50no
Response schema:
json
{
  "data": {
    "timeframe": "string",
    "total_net_flow": "number",
    "categories": [
      {
        "category": "string",
        "current_buy_volume": "number",
        "current_sell_volume": "number",
        "current_net_flow": "number",
        "previous_buy_volume": "number",
        "previous_sell_volume": "number",
        "previous_net_flow": "number",
        "net_flow_change": "number",
        "flow_trend": "string"
      }
    ],
    "biggest_inflow": "string",
    "biggest_outflow": "string"
  }
}
按分类统计的资金流（板块轮动）。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring7d24h, 7d, 30d否
smart_money_onlybooleanfalsetrue, false否
top_n_categoriesinteger201-50否
响应结构：
json
{
  "data": {
    "timeframe": "string",
    "total_net_flow": "number",
    "categories": [
      {
        "category": "string",
        "current_buy_volume": "number",
        "current_sell_volume": "number",
        "current_net_flow": "number",
        "previous_buy_volume": "number",
        "previous_sell_volume": "number",
        "previous_net_flow": "number",
        "net_flow_change": "number",
        "flow_trend": "string"
      }
    ],
    "biggest_inflow": "string",
    "biggest_outflow": "string"
  }
}

15. GET /api/v1/trades/whales

15. GET /api/v1/trades/whales

Large whale trades.
Parameters (query string):
ParamTypeDefaultValuesRequired
min_usdcnumber10000>= 1no
timeframestring24h1h, 4h, 12h, 24h, 7d, 30dno
condition_idstring--no
categorystring-any valid categoryno
sidestring-BUY, SELLno
smart_money_onlybooleanfalsetrue, falseno
limitinteger501-200no
Response schema:
json
{
  "data": [
    {
      "tx_hash": "string",
      "wallet": "string",
      "condition_id": "string",
      "token_id": "string",
      "question": "string",
      "outcome": "string",
      "category": "string",
      "side": "string",
      "price": "number",
      "size": "number",
      "usdc_size": "number",
      "timestamp": "string",
      "wallet_score": "number",
      "win_rate": "number",
      "wallet_tags": ["string"]
    }
  ]
}
Note: This endpoint returns REDEEM trades (resolved market payouts) alongside real trades. Filter by 
side=BUY
or 
side=SELL
to exclude them. REDEEMs have 
price=1.00
and 
side=REDEEM
.
大额鲸鱼交易。
参数（查询字符串）：
参数类型默认值可选值必填
min_usdcnumber10000>= 1否
timeframestring24h1h, 4h, 12h, 24h, 7d, 30d否
condition_idstring--否
categorystring-任意有效分类否
sidestring-BUY, SELL否
smart_money_onlybooleanfalsetrue, false否
limitinteger501-200否
响应结构：
json
{
  "data": [
    {
      "tx_hash": "string",
      "wallet": "string",
      "condition_id": "string",
      "token_id": "string",
      "question": "string",
      "outcome": "string",
      "category": "string",
      "side": "string",
      "price": "number",
      "size": "number",
      "usdc_size": "number",
      "timestamp": "string",
      "wallet_score": "number",
      "win_rate": "number",
      "wallet_tags": ["string"]
    }
  ]
}
注意： 该接口会同时返回REDEEM交易（已结算市场的 payout）和真实交易，可通过
side=BUY
或
side=SELL
过滤剔除REDEEM交易。REDEEM交易的
price=1.00
且
side=REDEEM
。

16. GET /api/v1/markets/volume-heatmap

16. GET /api/v1/markets/volume-heatmap

Volume distribution across categories, hours, or days.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring24h24h, 7d, 30dno
group_bystringcategorycategory, hour_of_day, day_of_weekno
smart_money_onlybooleanfalsetrue, falseno
Response schema:
json
{
  "data": {
    "total_volume": "number",
    "total_trades": "number",
    "breakdown": [
      {
        "label": "string",
        "volume": "number",
        "trade_count": "number",
        "pct_of_total": "number",
        "volume_change_pct": "number",
        "trend": "string"
      }
    ],
    "biggest_gainer": "string",
    "biggest_loser": "string"
  }
}
跨分类、小时或天的交易量分布。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring24h24h, 7d, 30d否
group_bystringcategorycategory, hour_of_day, day_of_week否
smart_money_onlybooleanfalsetrue, false否
响应结构：
json
{
  "data": {
    "total_volume": "number",
    "total_trades": "number",
    "breakdown": [
      {
        "label": "string",
        "volume": "number",
        "trade_count": "number",
        "pct_of_total": "number",
        "volume_change_pct": "number",
        "trend": "string"
      }
    ],
    "biggest_gainer": "string",
    "biggest_loser": "string"
  }
}

17. POST /api/v1/wallets/profile

17. POST /api/v1/wallets/profile

Full wallet dossier.
Request body (JSON):
FieldTypeDefaultValuesRequired
walletstring-lowercase addressyes
include_positionsbooleantruetrue, falseno
include_tradesbooleantruetrue, falseno
trades_limitinteger501-500no
Response schema:
json
{
  "data": {
    "wallet": "string",
    "profile": {
      "score": "number",
      "sharpe": "number",
      "win_rate": "number",
      "total_pnl": "number",
      "total_volume": "number",
      "resolved_positions": "number",
      "tags": ["string"],
      "tier": "string",
      "primary_category": "string",
      "is_specialist": "boolean"
    },
    "category_breakdown": "array",
    "active_positions": "array",
    "recent_trades": "array"
  }
}
Note: Wallet addresses MUST be lowercase.
完整的钱包档案。
请求体（JSON）：
字段类型默认值可选值必填
walletstring-小写地址是
include_positionsbooleantruetrue, false否
include_tradesbooleantruetrue, false否
trades_limitinteger501-500否
响应结构：
json
{
  "data": {
    "wallet": "string",
    "profile": {
      "score": "number",
      "sharpe": "number",
      "win_rate": "number",
      "total_pnl": "number",
      "total_volume": "number",
      "resolved_positions": "number",
      "tags": ["string"],
      "tier": "string",
      "primary_category": "string",
      "is_specialist": "boolean"
    },
    "category_breakdown": "array",
    "active_positions": "array",
    "recent_trades": "array"
  }
}
注意： 钱包地址必须为小写。

18. POST /api/v1/wallets/activity

18. POST /api/v1/wallets/activity

Recent trading activity for a wallet.
Request body (JSON):
FieldTypeDefaultValuesRequired
walletstring-lowercase addressyes
timeframestring24h1h, 4h, 24h, 7d, 30dno
categorystring-any valid categoryno
min_usdcnumber0>= 0no
limitinteger1001-500no
Response schema:
json
{
  "data": {
    "wallet": "string",
    "wallet_score": "number",
    "wallet_tags": ["string"],
    "period_summary": "object",
    "trades": "array"
  }
}
单个钱包的近期交易活动。
请求体（JSON）：
字段类型默认值可选值必填
walletstring-小写地址是
timeframestring24h1h, 4h, 24h, 7d, 30d否
categorystring-任意有效分类否
min_usdcnumber0>= 0否
limitinteger1001-500否
响应结构：
json
{
  "data": {
    "wallet": "string",
    "wallet_score": "number",
    "wallet_tags": ["string"],
    "period_summary": "object",
    "trades": "array"
  }
}

19. POST /api/v1/wallets/pnl-breakdown

19. POST /api/v1/wallets/pnl-breakdown

Per-market PnL breakdown.
Request body (JSON):
FieldTypeDefaultValuesRequired
walletstring-lowercase addressyes
timeframestring90d7d, 30d, 90d, allno
limitinteger501-200no
Response schema:
json
{
  "data": {
    "wallet": "string",
    "total_realized_pnl": "number",
    "total_positions": "number",
    "winning_positions": "number",
    "losing_positions": "number",
    "best_trade": "object",
    "worst_trade": "object",
    "positions": "array"
  }
}
按市场划分的PnL明细。
请求体（JSON）：
字段类型默认值可选值必填
walletstring-小写地址是
timeframestring90d7d, 30d, 90d, all否
limitinteger501-200否
响应结构：
json
{
  "data": {
    "wallet": "string",
    "total_realized_pnl": "number",
    "total_positions": "number",
    "winning_positions": "number",
    "losing_positions": "number",
    "best_trade": "object",
    "worst_trade": "object",
    "positions": "array"
  }
}

20. POST /api/v1/wallets/compare

20. POST /api/v1/wallets/compare

Compare 2-5 wallets side-by-side.
Request body (JSON):
FieldTypeDefaultValuesRequired
walletsstring[]-2-5 lowercase addressesyes
include_shared_positionsbooleantruetrue, falseno
Response schema:
json
{
  "data": {
    "wallets": "array of wallet profiles",
    "comparison_winners": "object",
    "category_overlap": "object",
    "shared_positions": "array"
  }
}
Pricing note: Cost scales with wallet count: 
base * wallets.length / 2
.
2-5个钱包的横向对比。
请求体（JSON）：
字段类型默认值可选值必填
walletsstring[]-2-5个小写地址是
include_shared_positionsbooleantruetrue, false否
响应结构：
json
{
  "data": {
    "wallets": "array of wallet profiles",
    "comparison_winners": "object",
    "category_overlap": "object",
    "shared_positions": "array"
  }
}
定价说明： 费用随钱包数量增长：
基础费用 * 钱包数量 / 2
。

21. POST /api/v1/wallets/copy-traders

21. POST /api/v1/wallets/copy-traders

Detect wallets copying a target wallet.
Request body (JSON):
FieldTypeDefaultValuesRequired
walletstring-lowercase addressyes
max_lag_minutesinteger601-1440no
timeframestring7d24h, 7d, 30dno
min_overlap_tradesinteger3>= 1no
limitinteger201-100no
Response schema:
json
{
  "data": [
    {
      "wallet": "string",
      "overlap_trades": "number",
      "avg_lag_seconds": "number",
      "copied_tokens": "array",
      "wallet_score": "number"
    }
  ]
}
检测复制目标钱包操作的跟单钱包。
请求体（JSON）：
字段类型默认值可选值必填
walletstring-小写地址是
max_lag_minutesinteger601-1440否
timeframestring7d24h, 7d, 30d否
min_overlap_tradesinteger3>= 1否
limitinteger201-100否
响应结构：
json
{
  "data": [
    {
      "wallet": "string",
      "overlap_trades": "number",
      "avg_lag_seconds": "number",
      "copied_tokens": "array",
      "wallet_score": "number"
    }
  ]
}

22. GET /api/v1/wallets/top-performers

22. GET /api/v1/wallets/top-performers

Leaderboard.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring7dtoday, 24h, 7d, 30d, 90d, 365dno
categorystring-any valid categoryno
metricstringpnlpnl, roi, sharpe, win_rate, volumeno
min_tradesinteger5>= 1no
limitinteger251-100no
Response schema:
json
{
  "data": [
    {
      "rank": "number",
      "wallet": "string",
      "period_pnl_usdc": "number",
      "period_roi_percent": "number",
      "period_trades": "number",
      "period_win_rate": "number",
      "overall_score": "number",
      "sharpe_ratio": "number",
      "primary_category": "string",
      "tags": ["string"],
      "active_positions_count": "number"
    }
  ]
}
Pricing note: Queries without a 
category
filter cost 2x due to full-table scan.
排行榜。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring7dtoday, 24h, 7d, 30d, 90d, 365d否
categorystring-任意有效分类否
metricstringpnlpnl, roi, sharpe, win_rate, volume否
min_tradesinteger5>= 1否
limitinteger251-100否
响应结构：
json
{
  "data": [
    {
      "rank": "number",
      "wallet": "string",
      "period_pnl_usdc": "number",
      "period_roi_percent": "number",
      "period_trades": "number",
      "period_win_rate": "number",
      "overall_score": "number",
      "sharpe_ratio": "number",
      "primary_category": "string",
      "tags": ["string"],
      "active_positions_count": "number"
    }
  ]
}
定价说明： 未携带
category
过滤的查询由于需要全表扫描，费用为2倍。

23. GET /api/v1/wallets/niche-experts

23. GET /api/v1/wallets/niche-experts

Top wallets in a specific category.
Parameters (query string):
ParamTypeDefaultValuesRequired
categorystring-any valid categoryyes
min_category_tradesinteger10>= 1no
sort_bystringcategory_sharpecategory_sharpe, category_pnl, category_volumeno
limitinteger251-100no
Response schema:
json
{
  "data": [
    {
      "wallet": "string",
      "category_sharpe": "number",
      "category_win_rate": "number",
      "category_volume": "number",
      "category_pnl": "number",
      "category_positions": "number",
      "is_specialist": "boolean",
      "volume_concentration": "number",
      "overall_score": "number",
      "tags": ["string"]
    }
  ]
}
特定分类的顶级钱包。
参数（查询字符串）：
参数类型默认值可选值必填
categorystring-任意有效分类是
min_category_tradesinteger10>= 1否
sort_bystringcategory_sharpecategory_sharpe, category_pnl, category_volume否
limitinteger251-100否
响应结构：
json
{
  "data": [
    {
      "wallet": "string",
      "category_sharpe": "number",
      "category_win_rate": "number",
      "category_volume": "number",
      "category_pnl": "number",
      "category_positions": "number",
      "is_specialist": "boolean",
      "volume_concentration": "number",
      "overall_score": "number",
      "tags": ["string"]
    }
  ]
}

24. GET /api/v1/markets/resolutions

24. GET /api/v1/markets/resolutions

Resolved markets with smart money accuracy.
Parameters (query string):
ParamTypeDefaultValuesRequired
categorystring-any valid categoryno
querystring-keywordno
sort_bystringresolved_recentlyresolved_recently, volume, smart_money_accuracyno
limitinteger251-100no
Response schema:
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "winning_outcome": "string",
      "end_date": "string",
      "total_volume_usdc": "number",
      "smart_money_correct": "number",
      "smart_money_wrong": "number",
      "smart_money_accuracy": "number"
    }
  ]
}
已结算市场及聪明钱预测准确率。
参数（查询字符串）：
参数类型默认值可选值必填
categorystring-任意有效分类否
querystring-关键词否
sort_bystringresolved_recentlyresolved_recently, volume, smart_money_accuracy否
limitinteger251-100否
响应结构：
json
{
  "data": [
    {
      "condition_id": "string",
      "question": "string",
      "category": "string",
      "winning_outcome": "string",
      "end_date": "string",
      "total_volume_usdc": "number",
      "smart_money_correct": "number",
      "smart_money_wrong": "number",
      "smart_money_accuracy": "number"
    }
  ]
}

25. GET /api/v1/wallets/alpha-callers

25. GET /api/v1/wallets/alpha-callers

Wallets that trade early on later-trending markets.
Parameters (query string):
ParamTypeDefaultValuesRequired
days_backinteger301-90no
min_days_earlyinteger71-60no
min_bet_usdcnumber100>= 0no
limitinteger251-100no
Response schema:
json
{
  "data": [
    {
      "wallet": "string",
      "market_question": "string",
      "condition_id": "string",
      "entry_date": "string",
      "days_before_resolution": "number",
      "bet_size_usdc": "number",
      "winning_outcome": "string",
      "wallet_score": "number",
      "win_rate": "number"
    }
  ]
}
提前布局后续热门市场的钱包。
参数（查询字符串）：
参数类型默认值可选值必填
days_backinteger301-90否
min_days_earlyinteger71-60否
min_bet_usdcnumber100>= 0否
limitinteger251-100否
响应结构：
json
{
  "data": [
    {
      "wallet": "string",
      "market_question": "string",
      "condition_id": "string",
      "entry_date": "string",
      "days_before_resolution": "number",
      "bet_size_usdc": "number",
      "winning_outcome": "string",
      "wallet_score": "number",
      "win_rate": "number"
    }
  ]
}

26. GET /api/v1/markets/dumb-money

26. GET /api/v1/markets/dumb-money

Low-score trader positions on a market (contrarian indicator).
Parameters (query string):
ParamTypeDefaultValuesRequired
condition_idstring--yes
max_scoreinteger300-100no
min_tradesinteger5>= 1no
limitinteger501-200no
Response schema:
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "summary": {
      "total_wallets": "number",
      "total_usdc": "number",
      "avg_score": "number",
      "consensus_outcome": "string"
    },
    "positions": "array"
  }
}
市场中低评分交易者持仓（反向指标）。
参数（查询字符串）：
参数类型默认值可选值必填
condition_idstring--是
max_scoreinteger300-100否
min_tradesinteger5>= 1否
limitinteger501-200否
响应结构：
json
{
  "data": {
    "condition_id": "string",
    "question": "string",
    "category": "string",
    "summary": {
      "total_wallets": "number",
      "total_usdc": "number",
      "avg_score": "number",
      "consensus_outcome": "string"
    },
    "positions": "array"
  }
}

27. GET /api/v1/wallets/insiders

27. GET /api/v1/wallets/insiders

Global insider candidates by behavioral score.
Parameters (query string):
ParamTypeDefaultValuesRequired
limitinteger501-200no
min_scoreinteger500-100no
max_wallet_age_daysinteger601-90no
Response schema:
json
{
  "data": {
    "candidates": [
      {
        "wallet": "string",
        "insider_score": "number",
        "wallet_age_days": "number",
        "first_trade": "string",
        "markets_traded": "number",
        "total_buy_usdc": "number",
        "category_count": "number",
        "categories": ["string"],
        "win_count": "number",
        "total_resolved": "number",
        "win_rate": "number",
        "signals": "object"
      }
    ],
    "total_candidates": "number"
  }
}
按行为评分筛选的全局内幕交易候选者。
参数（查询字符串）：
参数类型默认值可选值必填
limitinteger501-200否
min_scoreinteger500-100否
max_wallet_age_daysinteger601-90否
响应结构：
json
{
  "data": {
    "candidates": [
      {
        "wallet": "string",
        "insider_score": "number",
        "wallet_age_days": "number",
        "first_trade": "string",
        "markets_traded": "number",
        "total_buy_usdc": "number",
        "category_count": "number",
        "categories": ["string"],
        "win_count": "number",
        "total_resolved": "number",
        "win_rate": "number",
        "signals": "object"
      }
    ],
    "total_candidates": "number"
  }
}

HYPERLIQUID

HYPERLIQUID

28. GET /api/v1/hl/platform/stats

28. GET /api/v1/hl/platform/stats

Platform aggregate stats. No parameters.
Response schema:
json
{
  "data": {
    "total_volume_usd": "number",
    "total_trades": "number",
    "active_traders": "number",
    "smart_wallet_count": "number",
    "unique_coins": "number"
  }
}
平台聚合统计，无参数。
响应结构：
json
{
  "data": {
    "total_volume_usd": "number",
    "total_trades": "number",
    "active_traders": "number",
    "smart_wallet_count": "number",
    "unique_coins": "number"
  }
}

29. GET /api/v1/hl/coins/trending

29. GET /api/v1/hl/coins/trending

Trending coins by activity.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring24h1h, 4h, 12h, 24h, 7dno
limitinteger201-100no
Response schema:
json
{
  "data": [
    {
      "coin": "string",
      "volume_usd": "number",
      "trade_count": "number",
      "unique_traders": "number",
      "long_short_ratio": "number",
      "smart_wallet_count": "number",
      "volume_change_pct": "number"
    }
  ]
}
Known issue: 
timeframe=24h
often returns empty. Use 
timeframe=7d
as fallback.
按活跃度排序的热门币种。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring24h1h, 4h, 12h, 24h, 7d否
limitinteger201-100否
响应结构：
json
{
  "data": [
    {
      "coin": "string",
      "volume_usd": "number",
      "trade_count": "number",
      "unique_traders": "number",
      "long_short_ratio": "number",
      "smart_wallet_count": "number",
      "volume_change_pct": "number"
    }
  ]
}
已知问题： 
timeframe=24h
经常返回空结果，可使用
timeframe=7d
作为降级方案。

30. GET /api/v1/hl/coins/list

30. GET /api/v1/hl/coins/list

All traded coins with 7d stats.
Parameters (query string):
ParamTypeDefaultValuesRequired
limitinteger1001-500no
Response schema:
json
{
  "data": [
    {
      "coin": "string",
      "volume_usd": "number",
      "trade_count": "number",
      "unique_traders": "number"
    }
  ]
}
所有交易币种及7天统计。
参数（查询字符串）：
参数类型默认值可选值必填
limitinteger1001-500否
响应结构：
json
{
  "data": [
    {
      "coin": "string",
      "volume_usd": "number",
      "trade_count": "number",
      "unique_traders": "number"
    }
  ]
}

31. GET /api/v1/hl/coins/volume-heatmap

31. GET /api/v1/hl/coins/volume-heatmap

Volume by coin and hour.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring24h24h, 7dno
limitinteger201-50no
Response schema:
json
{
  "data": [
    {
      "coin": "string",
      "bucket": "string",
      "volume_usd": "number",
      "trade_count": "number",
      "smart_volume_usd": "number"
    }
  ]
}
按币种和小时统计的交易量。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring24h24h, 7d否
limitinteger201-50否
响应结构：
json
{
  "data": [
    {
      "coin": "string",
      "bucket": "string",
      "volume_usd": "number",
      "trade_count": "number",
      "smart_volume_usd": "number"
    }
  ]
}

32. GET /api/v1/hl/traders/leaderboard

32. GET /api/v1/hl/traders/leaderboard

Ranked trader leaderboard.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestringall1d, 7d, 30d, allno
sort_bystringpnlpnl, roi, win_rate, volumeno
sort_orderstringdescdesc, ascno
min_tradesinteger10>= 1no
limitinteger251-100no
Response schema:
json
{
  "data": [
    {
      "trader": "string",
      "total_pnl": "number",
      "total_volume": "number",
      "total_trades": "number",
      "winning_trades": "number",
      "win_rate": "number",
      "roi_pct": "number",
      "smart_score": "number"
    }
  ]
}
交易者排行榜。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestringall1d, 7d, 30d, all否
sort_bystringpnlpnl, roi, win_rate, volume否
sort_orderstringdescdesc, asc否
min_tradesinteger10>= 1否
limitinteger251-100否
响应结构：
json
{
  "data": [
    {
      "trader": "string",
      "total_pnl": "number",
      "total_volume": "number",
      "total_trades": "number",
      "winning_trades": "number",
      "win_rate": "number",
      "roi_pct": "number",
      "smart_score": "number"
    }
  ]
}

33. POST /api/v1/hl/traders/profile

33. POST /api/v1/hl/traders/profile

Full trader dossier.
Request body (JSON):
FieldTypeDefaultValuesRequired
traderstring-0x addressyes
daysinteger301-365no
trades_limitinteger501-500no
Response schema:
json
{
  "data": {
    "trader": "string",
    "stats": "object",
    "coin_breakdown": "array",
    "daily_pnl": "array",
    "recent_trades": "array"
  }
}
Known issue: Intermittent 500 errors. Fallback: use leaderboard + pnl-by-coin.
完整的交易者档案。
请求体（JSON）：
字段类型默认值可选值必填
traderstring-0x地址是
daysinteger301-365否
trades_limitinteger501-500否
响应结构：
json
{
  "data": {
    "trader": "string",
    "stats": "object",
    "coin_breakdown": "array",
    "daily_pnl": "array",
    "recent_trades": "array"
  }
}
已知问题： 偶发500错误，降级方案：使用排行榜 + 按币种PnL接口组合获取数据。

34. POST /api/v1/hl/traders/compare

34. POST /api/v1/hl/traders/compare

Compare 2-5 traders.
Request body (JSON):
FieldTypeDefaultValuesRequired
tradersstring[]-2-5 0x addressesyes
Response schema:
json
{
  "data": {
    "traders": "array of trader profiles",
    "shared_coins": "array",
    "comparison_winners": "object"
  }
}
Pricing note: Cost scales with trader count: 
base * traders.length / 2
.
2-5个交易者的横向对比。
请求体（JSON）：
字段类型默认值可选值必填
tradersstring[]-2-5个0x地址是
响应结构：
json
{
  "data": {
    "traders": "array of trader profiles",
    "shared_coins": "array",
    "comparison_winners": "object"
  }
}
定价说明： 费用随交易者数量增长：
基础费用 * 交易者数量 / 2
。

35. GET /api/v1/hl/traders/daily-pnl

35. GET /api/v1/hl/traders/daily-pnl

Daily PnL time series with streaks.
Parameters (query string):
ParamTypeDefaultValuesRequired
traderstring-0x addressyes
daysinteger301-365no
Response schema:
json
{
  "data": [
    {
      "date": "string",
      "pnl": "number",
      "volume": "number",
      "trades": "number",
      "cumulative_pnl": "number",
      "streak": "number"
    }
  ]
}
带连胜/连败记录的每日PnL时间序列。
参数（查询字符串）：
参数类型默认值可选值必填
traderstring-0x地址是
daysinteger301-365否
响应结构：
json
{
  "data": [
    {
      "date": "string",
      "pnl": "number",
      "volume": "number",
      "trades": "number",
      "cumulative_pnl": "number",
      "streak": "number"
    }
  ]
}

36. POST /api/v1/hl/traders/pnl-by-coin

36. POST /api/v1/hl/traders/pnl-by-coin

Per-coin PnL breakdown. Shows realized (closed) PnL only.
Request body (JSON):
FieldTypeDefaultValuesRequired
traderstring-0x addressyes
daysinteger901-365no
Response schema:
json
{
  "data": [
    {
      "coin": "string",
      "pnl": "number",
      "volume": "number",
      "trades": "number",
      "winning_trades": "number",
      "win_rate": "number"
    }
  ]
}
Note: Only realized (closed) PnL. Unrealized PnL from open positions is not available.
按币种划分的PnL明细，仅展示已平仓PnL。
请求体（JSON）：
字段类型默认值可选值必填
traderstring-0x地址是
daysinteger901-365否
响应结构：
json
{
  "data": [
    {
      "coin": "string",
      "pnl": "number",
      "volume": "number",
      "trades": "number",
      "winning_trades": "number",
      "win_rate": "number"
    }
  ]
}
注意： 仅包含已平仓PnL，不提供未平仓持仓的未实现PnL。

37. GET /api/v1/hl/traders/fresh-whales

37. GET /api/v1/hl/traders/fresh-whales

New high-volume wallets (experienced traders creating new accounts, institutional desks, or insiders).
Parameters (query string):
ParamTypeDefaultValuesRequired
max_wallet_age_daysinteger141-90no
min_volumenumber100000>= 0no
min_pnlnumber0anyno
limitinteger251-100no
Response schema:
json
{
  "data": [
    {
      "trader": "string",
      "first_trade": "string",
      "wallet_age_days": "number",
      "total_pnl": "number",
      "total_volume": "number",
      "total_trades": "number",
      "winning_trades": "number"
    }
  ]
}
新高交易量钱包（资深交易者新账号、机构账户或内幕交易者）。
参数（查询字符串）：
参数类型默认值可选值必填
max_wallet_age_daysinteger141-90否
min_volumenumber100000>= 0否
min_pnlnumber0任意否
limitinteger251-100否
响应结构：
json
{
  "data": [
    {
      "trader": "string",
      "first_trade": "string",
      "wallet_age_days": "number",
      "total_pnl": "number",
      "total_volume": "number",
      "total_trades": "number",
      "winning_trades": "number"
    }
  ]
}

38. GET /api/v1/hl/trades/whales

38. GET /api/v1/hl/trades/whales

Large trades.
Parameters (query string):
ParamTypeDefaultValuesRequired
min_usdnumber50000>= 1no
timeframestring24h1h, 4h, 12h, 24h, 7dno
coinstring-uppercase symbol (e.g. BTC)no
sidestring-Open Long, Open Short, Close Long, Close Shortno
directionstring-Long, Shortno
smart_money_onlybooleanfalsetrue, falseno
limitinteger501-200no
Response schema:
json
{
  "data": [
    {
      "trader": "string",
      "coin": "string",
      "side": "string",
      "direction": "string",
      "price": "number",
      "size": "number",
      "usd_value": "number",
      "closed_pnl": "number",
      "timestamp": "string",
      "smart_score": "number"
    }
  ]
}
大额交易。
参数（查询字符串）：
参数类型默认值可选值必填
min_usdnumber50000>= 1否
timeframestring24h1h, 4h, 12h, 24h, 7d否
coinstring-大写币种符号（例如BTC）否
sidestring-Open Long, Open Short, Close Long, Close Short否
directionstring-Long, Short否
smart_money_onlybooleanfalsetrue, false否
limitinteger501-200否
响应结构：
json
{
  "data": [
    {
      "trader": "string",
      "coin": "string",
      "side": "string",
      "direction": "string",
      "price": "number",
      "size": "number",
      "usd_value": "number",
      "closed_pnl": "number",
      "timestamp": "string",
      "smart_score": "number"
    }
  ]
}

39. GET /api/v1/hl/trades/feed

39. GET /api/v1/hl/trades/feed

Chronological trade feed for a coin.
Parameters (query string):
ParamTypeDefaultValuesRequired
coinstring-uppercase symbolyes
limitinteger1001-500no
Response schema:
json
{
  "data": [
    {
      "trader": "string",
      "coin": "string",
      "side": "string",
      "direction": "string",
      "price": "number",
      "size": "number",
      "usd_value": "number",
      "closed_pnl": "number",
      "timestamp": "string"
    }
  ]
}
单个币种的时间序交易流。
参数（查询字符串）：
参数类型默认值可选值必填
coinstring-大写币种符号是
limitinteger1001-500否
响应结构：
json
{
  "data": [
    {
      "trader": "string",
      "coin": "string",
      "side": "string",
      "direction": "string",
      "price": "number",
      "size": "number",
      "usd_value": "number",
      "closed_pnl": "number",
      "timestamp": "string"
    }
  ]
}

40. GET /api/v1/hl/trades/long-short-ratio

40. GET /api/v1/hl/trades/long-short-ratio

Long/short volume ratio time series.
Parameters (query string):
ParamTypeDefaultValuesRequired
coinstring-uppercase symbolyes
timeframestring7d24h, 7d, 30dno
bucket_sizestring4h1h, 4h, 12h, 1dno
Response schema:
json
{
  "data": [
    {
      "bucket": "string",
      "long_volume": "number",
      "short_volume": "number",
      "long_short_ratio": "number",
      "smart_long_volume": "number",
      "smart_short_volume": "number",
      "smart_long_short_ratio": "number"
    }
  ]
}
Known issue: May return all zeros. Fallback: reconstruct from 
/hl/trades/whales
by counting long vs short volume.
多空交易量比时间序列。
参数（查询字符串）：
参数类型默认值可选值必填
coinstring-大写币种符号是
timeframestring7d24h, 7d, 30d否
bucket_sizestring4h1h, 4h, 12h, 1d否
响应结构：
json
{
  "data": [
    {
      "bucket": "string",
      "long_volume": "number",
      "short_volume": "number",
      "long_short_ratio": "number",
      "smart_long_volume": "number",
      "smart_short_volume": "number",
      "smart_long_short_ratio": "number"
    }
  ]
}
已知问题： 可能返回全零结果，降级方案：通过
/hl/trades/whales
统计多空交易量重构数据。

41. GET /api/v1/hl/smart-wallets/list

41. GET /api/v1/hl/smart-wallets/list

Smart wallet list.
Parameters (query string):
ParamTypeDefaultValuesRequired
sort_bystringscorescore, pnl, volumeno
limitinteger501-200no
Response schema:
json
{
  "data": [
    {
      "trader": "string",
      "score": "number",
      "total_pnl": "number",
      "total_volume": "number",
      "total_trades": "number",
      "win_rate": "number"
    }
  ]
}
聪明钱包列表。
参数（查询字符串）：
参数类型默认值可选值必填
sort_bystringscorescore, pnl, volume否
limitinteger501-200否
响应结构：
json
{
  "data": [
    {
      "trader": "string",
      "score": "number",
      "total_pnl": "number",
      "total_volume": "number",
      "total_trades": "number",
      "win_rate": "number"
    }
  ]
}

42. GET /api/v1/hl/smart-wallets/activity

42. GET /api/v1/hl/smart-wallets/activity

Smart wallet recent trades.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring24h1h, 4h, 12h, 24h, 7dno
min_scoreinteger600-100no
limitinteger1001-500no
Response schema:
json
{
  "data": {
    "period_summary": "object",
    "trades": "array"
  }
}
聪明钱包近期交易。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring24h1h, 4h, 12h, 24h, 7d否
min_scoreinteger600-100否
limitinteger1001-500否
响应结构：
json
{
  "data": {
    "period_summary": "object",
    "trades": "array"
  }
}

43. GET /api/v1/hl/smart-wallets/signals

43. GET /api/v1/hl/smart-wallets/signals

Aggregated directional signals by coin.
Parameters (query string):
ParamTypeDefaultValuesRequired
timeframestring24h6h, 12h, 24h, 7dno
min_scoreinteger600-100no
limitinteger201-50no
Response schema:
json
{
  "data": [
    {
      "coin": "string",
      "direction": "string",
      "smart_wallet_count": "number",
      "total_volume": "number",
      "avg_score": "number",
      "top_traders": "array"
    }
  ]
}
Known issue: 
timeframe=24h
often returns empty. Use 
timeframe=7d
as fallback.
按币种聚合的方向信号。
参数（查询字符串）：
参数类型默认值可选值必填
timeframestring24h6h, 12h, 24h, 7d否
min_scoreinteger600-100否
limitinteger201-50否
响应结构：
json
{
  "data": [
    {
      "coin": "string",
      "direction": "string",
      "smart_wallet_count": "number",
      "total_volume": "number",
      "avg_score": "number",
      "top_traders": "array"
    }
  ]
}
已知问题： 
timeframe=24h
经常返回空结果，可使用
timeframe=7d
作为降级方案。

44. GET /api/v1/hl/pressure/pairs

44. GET /api/v1/hl/pressure/pairs

Long/short pressure with smart positions.
Parameters (query string):
ParamTypeDefaultValuesRequired
coinsstring-comma-separated (defaults to top 10)no
trades_limitinteger201-100no
Response schema:
json
{
  "data": {
    "coins": [
      {
        "coin": "string",
        "long_pressure": "number",
        "short_pressure": "number",
        "long_avg_entry": "number",
        "short_avg_entry": "number",
        "long_smart_count": "number",
        "short_smart_count": "number",
        "smart_positions": "array"
      }
    ]
  }
}
带聪明钱持仓的多空压力。
参数（查询字符串）：
参数类型默认值可选值必填
coinsstring-逗号分隔（默认返回前10）否
trades_limitinteger201-100否
响应结构：
json
{
  "data": {
    "coins": [
      {
        "coin": "string",
        "long_pressure": "number",
        "short_pressure": "number",
        "long_avg_entry": "number",
        "short_avg_entry": "number",
        "long_smart_count": "number",
        "short_smart_count": "number",
        "smart_positions": "array"
      }
    ]
  }
}

45. GET /api/v1/hl/pressure/summary

45. GET /api/v1/hl/pressure/summary

Pressure summary across all coins. No parameters.
Response schema:
json
{
  "data": {
    "coins": [
      {
        "coin": "string",
        "long_pressure": "number",
        "short_pressure": "number",
        "long_percent": "number",
        "short_percent": "number",
        "long_avg_entry": "number",
        "short_avg_entry": "number"
      }
    ]
  }
}
所有币种的压力汇总，无参数。
响应结构：
json
{
  "data": {
    "coins": [
      {
        "coin": "string",
        "long_pressure": "number",
        "short_pressure": "number",
        "long_percent": "number",
        "short_percent": "number",
        "long_avg_entry": "number",
        "short_avg_entry": "number"
      }
    ]
  }
}

METEORA

METEORA

46. GET /api/v1/meteora/pools/trending

46. GET /api/v1/meteora/pools/trending

Trending pools by volume spike.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allno
timeframestring24h24h, 7dno
limitinteger201-100no
Response schema:
json
{
  "data": [
    {
      "pool_address": "string",
      "pool_type": "string",
      "token_x": "string",
      "token_y": "string",
      "volume_usd": "number",
      "event_count": "number",
      "unique_lps": "number",
      "volume_change_pct": "number"
    }
  ]
}
Known issue: May contain duplicate entries. Deduplicate by 
pool_address
.
交易量激增的热门资金池。
参数（查询字符串）：
参数类型默认值可选值必填
pool_typestringalldlmm, damm_v2, all否
timeframestring24h24h, 7d否
limitinteger201-100否
响应结构：
json
{
  "data": [
    {
      "pool_address": "string",
      "pool_type": "string",
      "token_x": "string",
      "token_y": "string",
      "volume_usd": "number",
      "event_count": "number",
      "unique_lps": "number",
      "volume_change_pct": "number"
    }
  ]
}
已知问题： 可能包含重复条目，请按
pool_address
去重。

47. GET /api/v1/meteora/pools/top

47. GET /api/v1/meteora/pools/top

Top pools by volume, fees, or LP count.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allno
sort_bystringvolumevolume, lp_count, events, feesno
timeframestring7d24h, 7d, 30dno
limitinteger201-100no
Response schema:
json
{
  "data": [
    {
      "pool_address": "string",
      "pool_type": "string",
      "token_x": "string",
      "token_y": "string",
      "volume_usd": "number",
      "event_count": "number",
      "unique_lps": "number",
      "total_fees_usd": "number"
    }
  ]
}
按交易量、手续费、LP数量排序的顶级资金池。
参数（查询字符串）：
参数类型默认值可选值必填
pool_typestringalldlmm, damm_v2, all否
sort_bystringvolumevolume, lp_count, events, fees否
timeframestring7d24h, 7d, 30d否
limitinteger201-100否
响应结构：
json
{
  "data": [
    {
      "pool_address": "string",
      "pool_type": "string",
      "token_x": "string",
      "token_y": "string",
      "volume_usd": "number",
      "event_count": "number",
      "unique_lps": "number",
      "total_fees_usd": "number"
    }
  ]
}

48. GET /api/v1/meteora/pools/search

48. GET /api/v1/meteora/pools/search

Search pools by address or token name.
Parameters (query string):
ParamTypeDefaultValuesRequired
querystring-pool address or token nameyes
pool_typestringalldlmm, damm_v2, allno
limitinteger101-50no
Response schema:
json
{
  "data": [
    {
      "pool_address": "string",
      "pool_type": "string",
      "token_x": "string",
      "token_y": "string",
      "volume_usd": "number",
      "event_count": "number",
      "unique_lps": "number"
    }
  ]
}
按地址或代币名称搜索资金池。
参数（查询字符串）：
参数类型默认值可选值必填
querystring-资金池地址或代币名称是
pool_typestringalldlmm, damm_v2, all否
limitinteger101-50否
响应结构：
json
{
  "data": [
    {
      "pool_address": "string",
      "pool_type": "string",
      "token_x": "string",
      "token_y": "string",
      "volume_usd": "number",
      "event_count": "number",
      "unique_lps": "number"
    }
  ]
}

49. GET /api/v1/meteora/pools/detail

49. GET /api/v1/meteora/pools/detail

Full pool detail.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyyes
pool_typestring-dlmm, damm_v2 (auto-detected if omitted)no
Response schema:
json
{
  "data": {
    "pool_address": "string",
    "pool_type": "string",
    "token_x": "string",
    "token_y": "string",
    "total_volume_usd": "number",
    "total_events": "number",
    "unique_lps": "number",
    "volume_by_action": "object",
    "net_liquidity_usd": "number"
  }
}
完整的资金池详情。
参数（查询字符串）：
参数类型默认值可选值必填
pool_addressstring-Solana公钥是
pool_typestring-dlmm, damm_v2（省略则自动检测）否
响应结构：
json
{
  "data": {
    "pool_address": "string",
    "pool_type": "string",
    "token_x": "string",
    "token_y": "string",
    "total_volume_usd": "number",
    "total_events": "number",
    "unique_lps": "number",
    "volume_by_action": "object",
    "net_liquidity_usd": "number"
  }
}

50. GET /api/v1/meteora/pools/volume-history

50. GET /api/v1/meteora/pools/volume-history

Volume time series.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyyes
pool_typestring-dlmm, damm_v2 (auto-detected if omitted)no
timeframestring7d24h, 7d, 30dno
bucket_sizestring4h1h, 4h, 1dno
Response schema:
json
{
  "data": [
    {
      "bucket": "string",
      "volume_usd": "number",
      "event_count": "number",
      "action_breakdown": "object"
    }
  ]
}
交易量时间序列。
参数（查询字符串）：
参数类型默认值可选值必填
pool_addressstring-Solana公钥是
pool_typestring-dlmm, damm_v2（省略则自动检测）否
timeframestring7d24h, 7d, 30d否
bucket_sizestring4h1h, 4h, 1d否
响应结构：
json
{
  "data": [
    {
      "bucket": "string",
      "volume_usd": "number",
      "event_count": "number",
      "action_breakdown": "object"
    }
  ]
}

51. GET /api/v1/meteora/pools/events

51. GET /api/v1/meteora/pools/events

Chronological event feed.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyyes
pool_typestring-dlmm, damm_v2 (auto-detected if omitted)no
limitinteger1001-500no
Response schema:
json
{
  "data": [
    {
      "owner": "string",
      "pool_address": "string",
      "event_type": "string",
      "usd_total": "number",
      "timestamp": "string",
      "tx_id": "string"
    }
  ]
}
时间序事件流。
参数（查询字符串）：
参数类型默认值可选值必填
pool_addressstring-Solana公钥是
pool_typestring-dlmm, damm_v2（省略则自动检测）否
limitinteger1001-500否
响应结构：
json
{
  "data": [
    {
      "owner": "string",
      "pool_address": "string",
      "event_type": "string",
      "usd_total": "number",
      "timestamp": "string",
      "tx_id": "string"
    }
  ]
}

52. GET /api/v1/meteora/pools/fee-analysis

52. GET /api/v1/meteora/pools/fee-analysis

Fee claiming analysis.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyyes
pool_typestring-dlmm, damm_v2 (auto-detected if omitted)no
timeframestring7d24h, 7d, 30dno
Response schema:
json
{
  "data": {
    "pool_address": "string",
    "total_fees_claimed": "number",
    "unique_claimers": "number",
    "time_series": "array",
    "top_claimers": "array"
  }
}
手续费领取分析。
参数（查询字符串）：
参数类型默认值可选值必填
pool_addressstring-Solana公钥是
pool_typestring-dlmm, damm_v2（省略则自动检测）否
timeframestring7d24h, 7d, 30d否
响应结构：
json
{
  "data": {
    "pool_address": "string",
    "total_fees_claimed": "number",
    "unique_claimers": "number",
    "time_series": "array",
    "top_claimers": "array"
  }
}

53. GET /api/v1/meteora/lps/top

53. GET /api/v1/meteora/lps/top

Top LPs leaderboard.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allno
sort_bystringvolumevolume, pool_count, eventsno
timeframestring30d7d, 30dno
limitinteger251-100no
Response schema:
json
{
  "data": [
    {
      "owner": "string",
      "total_volume_usd": "number",
      "pool_count": "number",
      "event_count": "number",
      "pool_types": ["string"]
    }
  ]
}
Known issue: 
sort_by=fees
may return 500. Use 
sort_by=volume
as fallback.
顶级LP排行榜。
参数（查询字符串）：
参数类型默认值可选值必填
pool_typestringalldlmm, damm_v2, all否
sort_bystringvolumevolume, pool_count, events否
timeframestring30d7d, 30d否
limitinteger251-100否
响应结构：
json
{
  "data": [
    {
      "owner": "string",
      "total_volume_usd": "number",
      "pool_count": "number",
      "event_count": "number",
      "pool_types": ["string"]
    }
  ]
}
已知问题： 
sort_by=fees
可能返回500错误，使用
sort_by=volume
作为降级方案。

54. POST /api/v1/meteora/lps/profile

54. POST /api/v1/meteora/lps/profile

Full LP dossier.
Request body (JSON):
FieldTypeDefaultValuesRequired
ownerstring-Solana pubkeyyes
pool_typestringalldlmm, damm_v2, allno
events_limitinteger501-500no
Response schema:
json
{
  "data": {
    "owner": "string",
    "summary": "object",
    "pool_breakdown": "array",
    "recent_events": "array"
  }
}
完整的LP档案。
请求体（JSON）：
字段类型默认值可选值必填
ownerstring-Solana公钥是
pool_typestringalldlmm, damm_v2, all否
events_limitinteger501-500否
响应结构：
json
{
  "data": {
    "owner": "string",
    "summary": "object",
    "pool_breakdown": "array",
    "recent_events": "array"
  }
}

55. GET /api/v1/meteora/lps/whales

55. GET /api/v1/meteora/lps/whales

Large LP events.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allno
min_usdnumber10000>= 1no
timeframestring24h24h, 7d, 30dno
limitinteger501-200no
Response schema:
json
{
  "data": [
    {
      "owner": "string",
      "pool_address": "string",
      "pool_type": "string",
      "event_type": "string",
      "usd_total": "number",
      "timestamp": "string"
    }
  ]
}
大额LP事件。
参数（查询字符串）：
参数类型默认值可选值必填
pool_typestringalldlmm, damm_v2, all否
min_usdnumber10000>= 1否
timeframestring24h24h, 7d, 30d否
limitinteger501-200否
响应结构：
json
{
  "data": [
    {
      "owner": "string",
      "pool_address": "string",
      "pool_type": "string",
      "event_type": "string",
      "usd_total": "number",
      "timestamp": "string"
    }
  ]
}

56. POST /api/v1/meteora/lps/compare

56. POST /api/v1/meteora/lps/compare

Compare 2-5 LPs.
Request body (JSON):
FieldTypeDefaultValuesRequired
ownersstring[]-2-5 Solana pubkeysyes
pool_typestringalldlmm, damm_v2, allno
Response schema:
json
{
  "data": {
    "lps": "array of LP profiles",
    "shared_pools": "array",
    "comparison_winners": "object"
  }
}
Pricing note: Cost scales with LP count: 
base * owners.length / 2
.
2-5个LP的横向对比。
请求体（JSON）：
字段类型默认值可选值必填
ownersstring[]-2-5个Solana公钥是
pool_typestringalldlmm, damm_v2, all否
响应结构：
json
{
  "data": {
    "lps": "array of LP profiles",
    "shared_pools": "array",
    "comparison_winners": "object"
  }
}
定价说明： 费用随LP数量增长：
基础费用 * LP数量 / 2
。

57. GET /api/v1/meteora/positions/active

57. GET /api/v1/meteora/positions/active

Active LP positions.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyno
ownerstring-Solana pubkeyno
pool_typestringalldlmm, damm_v2, allno
limitinteger501-200no
Response schema:
json
{
  "data": [
    {
      "owner": "string",
      "pool_address": "string",
      "pool_type": "string",
      "position_address": "string",
      "deposited_usd": "number",
      "withdrawn_usd": "number",
      "net_value_usd": "number",
      "event_count": "number"
    }
  ]
}
活跃LP持仓。
参数（查询字符串）：
参数类型默认值可选值必填
pool_addressstring-Solana公钥否
ownerstring-Solana公钥否
pool_typestringalldlmm, damm_v2, all否
limitinteger501-200否
响应结构：
json
{
  "data": [
    {
      "owner": "string",
      "pool_address": "string",
      "pool_type": "string",
      "position_address": "string",
      "deposited_usd": "number",
      "withdrawn_usd": "number",
      "net_value_usd": "number",
      "event_count": "number"
    }
  ]
}

58. GET /api/v1/meteora/positions/history

58. GET /api/v1/meteora/positions/history

Position event history (DLMM only).
Parameters (query string):
ParamTypeDefaultValuesRequired
position_addressstring--yes
Response schema:
json
{
  "data": {
    "position_address": "string",
    "events": [
      {
        "event_type": "string",
        "usd_total": "number",
        "timestamp": "string",
        "tx_id": "string"
      }
    ]
  }
}
持仓事件历史（仅DLMM）。
参数（查询字符串）：
参数类型默认值可选值必填
position_addressstring--是
响应结构：
json
{
  "data": {
    "position_address": "string",
    "events": [
      {
        "event_type": "string",
        "usd_total": "number",
        "timestamp": "string",
        "tx_id": "string"
      }
    ]
  }
}

59. GET /api/v1/meteora/platform/stats

59. GET /api/v1/meteora/platform/stats

Platform-wide stats.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allno
Response schema:
json
{
  "data": {
    "total_volume_usd": "number",
    "total_events": "number",
    "active_lps": "number",
    "active_pools": "number",
    "by_pool_type": "object"
  }
}
平台整体统计。
参数（查询字符串）：
参数类型默认值可选值必填
pool_typestringalldlmm, damm_v2, all否
响应结构：
json
{
  "data": {
    "total_volume_usd": "number",
    "total_events": "number",
    "active_lps": "number",
    "active_pools": "number",
    "by_pool_type": "object"
  }
}

60. GET /api/v1/meteora/platform/volume-heatmap

60. GET /api/v1/meteora/platform/volume-heatmap

Volume by action/hour.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allno
timeframestring24h24h, 7dno
Response schema:
json
{
  "data": [
    {
      "action": "string",
      "bucket": "string",
      "pool_type": "string",
      "volume_usd": "number",
      "event_count": "number"
    }
  ]
}
按操作/小时统计的交易量。
参数（查询字符串）：
参数类型默认值可选值必填
pool_typestringalldlmm, damm_v2, all否
timeframestring24h24h, 7d否
响应结构：
json
{
  "data": [
    {
      "action": "string",
      "bucket": "string",
      "pool_type": "string",
      "volume_usd": "number",
      "event_count": "number"
    }
  ]
}

61. GET /api/v1/meteora/platform/metengine-share

61. GET /api/v1/meteora/platform/metengine-share

MetEngine routing share.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allno
timeframestring7d24h, 7d, 30dno
Response schema:
json
{
  "data": {
    "total_events": "number",
    "metengine_events": "number",
    "metengine_share_pct": "number",
    "total_volume_usd": "number",
    "metengine_volume_usd": "number"
  }
}
MetEngine路由占比。
参数（查询字符串）：
参数类型默认值可选值必填
pool_typestringalldlmm, damm_v2, all否
timeframestring7d24h, 7d, 30d否
响应结构：
json
{
  "data": {
    "total_events": "number",
    "metengine_events": "number",
    "metengine_share_pct": "number",
    "total_volume_usd": "number",
    "metengine_volume_usd": "number"
  }
}

62. GET /api/v1/meteora/dca/pressure

62. GET /api/v1/meteora/dca/pressure

DCA accumulation pressure by token.
Parameters (query string):
ParamTypeDefaultValuesRequired
tokenstring-specific mint addressno
timeframestring1h1m, 5m, 30m, 1h, 6h, 24hno
Response schema (single token):
json
{
  "data": {
    "tokenMint": "string",
    "timeframe": "string",
    "buyVolume": "number",
    "sellVolume": "number",
    "netPressure": "number",
    "score": "number"
  }
}
Response schema (all tokens, when 
token
omitted):
json
{
  "data": {
    "timeframe": "string",
    "tokens": "array",
    "lastUpdated": "string"
  }
}
按代币统计的DCA积累压力。
参数（查询字符串）：
参数类型默认值可选值必填
tokenstring-特定mint地址否
timeframestring1h1m, 5m, 30m, 1h, 6h, 24h否
响应结构（单个代币）：
json
{
  "data": {
    "tokenMint": "string",
    "timeframe": "string",
    "buyVolume": "number",
    "sellVolume": "number",
    "netPressure": "number",
    "score": "number"
  }
}
响应结构（所有代币，省略
token
参数时）：
json
{
  "data": {
    "timeframe": "string",
    "tokens": "array",
    "lastUpdated": "string"
  }
}

63. GET /api/v1/meteora/pools/smart-wallet

63. GET /api/v1/meteora/pools/smart-wallet

Pools with highest smart wallet LP activity.
Parameters (query string):
ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allno
limitinteger201-100no
timeframestring7d24h, 7d, 30dno
Response schema:
json
{
  "data": {
    "pools": [
      {
        "pool_address": "string",
        "pool_type": "string",
        "token_a": "string",
        "token_b": "string",
        "smart_lp_count": "number",
        "total_volume_usd": "number",
        "smart_volume_usd": "number",
        "smart_share_pct": "number"
      }
    ]
  }
}
聪明钱LP活跃度最高的资金池。
参数（查询字符串）：
参数类型默认值可选值必填
pool_typestringalldlmm, damm_v2, all否
limitinteger201-100否
timeframestring7d24h, 7d, 30d否
响应结构：
json
{
  "data": {
    "pools": [
      {
        "pool_address": "string",
        "pool_type": "string",
        "token_a": "string",
        "token_b": "string",
        "smart_lp_count": "number",
        "total_volume_usd": "number",
        "smart_volume_usd": "number",
        "smart_share_pct": "number"
      }
    ]
  }
}

Comparison to Self-Computation

与自行计算的对比

Why call this API instead of computing it yourself

为什么调用该API而非自行计算

1. Proprietary scored dataset. MetEngine maintains wallet scoring models across all three platforms (Polymarket 0-100 composite score, Hyperliquid 0-100 smart score, Meteora LP smart score). These scores are computed from billions of historical trades, resolved positions, and behavioral patterns. An agent would need to: (a) index 574M+ Polymarket trades, (b) build and maintain a scoring pipeline, (c) store and update scores for millions of wallets. Self-computation cost: weeks of engineering + ongoing infrastructure.
2. Pre-aggregated materialized views. Queries that would require scanning 574M+ trade rows (capital flow by category, top performers, insider detection) run against pre-aggregated SummingMergeTree tables. A raw ClickHouse scan of the trades table would take 30-60 seconds and cost $0.50-2.00 in compute. The API returns results in 1-5 seconds for $0.01-0.08.
3. Cross-platform intelligence. Insider detection uses a 7-signal behavioral scoring system. Smart money consensus compares scored wallets against market prices. Capital flow tracks sector rotation across all categories. Building this from raw on-chain data requires indexing multiple chains, maintaining market metadata, and running continuous scoring pipelines.
4. Real-time on-chain data. The API indexes Polymarket (Polygon), Hyperliquid (L1), and Meteora (Solana) trade data with sub-minute latency. An agent would need RPC nodes on 3 chains, event parsing, and database infrastructure.
Cost comparison for a typical workflow (analyze a Polymarket market):
StepSelf-ComputationMetEngine API
Find marketScrape Polymarket frontendGET /markets/search ($0.01)
Get smart money consensusIndex all trades, score wallets, aggregatePOST /markets/intelligence ($0.05)
Get price historyParse on-chain events, build OHLCVGET /markets/price-history ($0.01)
Find insider patternsBuild 7-signal detection pipelinePOST /markets/insiders ($0.05)
TotalHours of compute + infra$0.12, ~10 seconds
1. 专有评分数据集 MetEngine维护了覆盖三个平台的钱包评分模型（Polymarket 0-100综合评分、Hyperliquid 0-100聪明评分、Meteora LP聪明评分），这些评分基于数十亿条历史交易、已结算持仓和行为模式计算得出。Agent如果要自行实现需要：(a) 索引5.74亿+条Polymarket交易，(b) 搭建并维护评分流水线，(c) 存储并更新数百万个钱包的评分。自行计算成本：数周的开发工作 + 持续的基础设施开销。
2. 预聚合物化视图 需要扫描5.74亿+条交易记录的查询（分类资金流、顶级交易者、内幕交易检测）直接基于预聚合的SummingMergeTree表返回结果。原始ClickHouse扫描交易表需要30-60秒，计算成本为$0.50-2.00，而API仅需1-5秒，费用仅$0.01-0.08。
3. 跨平台智能分析 内幕交易检测采用7信号行为评分系统，聪明钱共识将评分钱包与市场价格对比，资金流追踪所有分类的板块轮动。从原始链上数据搭建这些能力需要索引多条链、维护市场元数据、运行持续的评分流水线。
4. 实时链上数据 API以亚分钟级延迟索引Polymarket（Polygon）、Hyperliquid（L1）和Meteora（Solana）的交易数据。Agent自行实现需要3条链的RPC节点、事件解析和数据库基础设施。
典型工作流成本对比（分析单个Polymarket市场）：
步骤自行计算MetEngine API
查找市场爬取Polymarket前端GET /markets/search ($0.01)
获取聪明钱共识索引所有交易、评分钱包、聚合计算POST /markets/intelligence ($0.05)
获取价格历史解析链上事件、构建OHLCVGET /markets/price-history ($0.01)
发现内幕交易模式搭建7信号检测流水线POST /markets/insiders ($0.05)
总计数小时计算 + 基础设施成本$0.12，约10秒返回

Performance

性能

MetricValue
p50 latency800ms
p95 latency3s
p99 latency8s
Handler timeout60s (no payment charged on timeout)
Max concurrent paid requests50
Payment verification timeout5s
Rate limit (unpaid 402 requests)IP-based, generous
指标值
p50延迟800ms
p95延迟3s
p99延迟8s
处理超时60s（超时不收取费用）
最大并发付费请求50
支付验证超时5s
速率限制（未付费402请求）IP基，额度宽松

Data Freshness

数据新鲜度

PlatformFreshness
Polymarket tradesSub-minute (continuous indexing)
Polymarket wallet scoresDaily recompute
Hyperliquid tradesSub-minute
Hyperliquid smart scoresContinuous (formula-based)
Meteora eventsSub-minute
Meteora LP scoresDaily recompute
平台新鲜度
Polymarket交易亚分钟（持续索引）
Polymarket钱包评分每日重算
Hyperliquid交易亚分钟
Hyperliquid聪明评分实时（公式计算）
Meteora事件亚分钟
Meteora LP评分每日重算

Error Handling

错误处理

HTTP Status Codes

HTTP状态码

CodeMeaningAgent Action
200Success. Data in 
{ "data": ... }
. Settlement proof in 
PAYMENT-RESPONSE
header.		Process data
400Bad request (invalid params, malformed payment header)Fix request params
402Payment required (first request) or payment verification failedSign and re-send with payment, or check payment validity
404Endpoint not foundVerify endpoint path against this document
429Rate limit exceededBack off and retry
500Internal server errorRetry once, then try fallback endpoint
502Payment verification failed (facilitator error)Retry
503Server at capacity or payment service unavailableCheck 
Retry-After
header, retry after delay
504Query execution timeout. No payment charged.Retry with narrower params or use fallback endpoint
状态码含义Agent操作
200成功，数据在
{ "data": ... }
中，结算证明在
PAYMENT-RESPONSE
头		处理数据
400请求错误（参数无效、支付头格式错误）修复请求参数
402需要支付（首次请求）或支付验证失败签名后携带支付信息重发，或检查支付有效性
404接口不存在对照本文档验证接口路径
429超出速率限制退避后重试
500内部服务器错误重试一次，若失败则使用降级接口
502支付验证失败（服务商错误）重试
503服务器满载或支付服务不可用检查
Retry-After
头，延迟后重试
504查询执行超时，不收取费用使用更窄的参数重试，或使用降级接口

Error Response Format

错误响应格式

json
{
  "error": "Human-readable error message",
  "reason": "Optional machine-readable reason (on 402 verification failures)"
}
json
{
  "error": "人类可读错误信息",
  "reason": "可选的机器可读原因（402验证失败时返回）"
}

Settlement Edge Cases

结算边界情况

HeaderMeaning
X-Payment-Settlement: failed
Query succeeded but settlement failed. Data returned, no charge. Rare edge case.
No 
PAYMENT-RESPONSE
header on 200		Settlement was not attempted (should not happen in normal flow).
头含义
X-Payment-Settlement: failed
查询成功但结算失败，返回数据，不收费，罕见边界情况
200响应中无
PAYMENT-RESPONSE
头		未尝试结算（正常流程不会发生）

Fallback Strategies

降级策略

When an endpoint fails, use these alternatives:
Failed EndpointFallback
/markets/opportunities (504)/markets/high-conviction
/wallets/top-performers (503 on 7d)Try timeframe=24h
/markets/insiders (timeout)/markets/trades with market filter
/hl/coins/trending (empty on 24h)Use timeframe=7d
/hl/smart-wallets/signals (empty on 24h)Use timeframe=7d
/hl/trades/long-short-ratio (all zeros)Reconstruct from /hl/trades/whales by side
/hl/traders/profile (500)/hl/traders/leaderboard + /hl/traders/pnl-by-coin
/meteora/lps/top?sort_by=fees (500)Use sort_by=volume
/meteora/lps/profile (500)/meteora/pools/fee-analysis for claimer data
接口失败时使用以下替代方案：
失败接口降级方案
/markets/opportunities (504)/markets/high-conviction
/wallets/top-performers (7d时间范围返回503)尝试timeframe=24h
/markets/insiders (超时)带市场过滤的/markets/trades
/hl/coins/trending (24h时间范围返回空)使用timeframe=7d
/hl/smart-wallets/signals (24h时间范围返回空)使用timeframe=7d
/hl/trades/long-short-ratio (返回全零)通过/hl/trades/whales按方向统计重构
/hl/traders/profile (500)/hl/traders/leaderboard + /hl/traders/pnl-by-coin
/meteora/lps/top?sort_by=fees (500)使用sort_by=volume
/meteora/lps/profile (500)使用/meteora/pools/fee-analysis获取领取者数据

Health Check

健康检查

GET https://agent.metengine.xyz/health
Free. No payment required. Returns:
json
{
  "status": "ok | degraded",
  "service": "data-agent",
  "auth_mode": "x402",
  "clickhouse": { "status": "ok | down" },
  "postgres": { "status": "ok | down" },
  "redis": { "status": "ok | down" },
  "semaphore": {
    "active": "number",
    "waiting": "number",
    "max": 250,
    "timeouts_1m": "number"
  },
  "queries_1m": "object",
  "cache_1m": "object",
  "top_errors": "object",
  "facilitator": "boolean",
  "network": "mainnet"
}
  • status: "ok"
    means all backends are healthy.
  • status: "degraded"
    means at least one backend is down. Check individual component statuses.
  • facilitator: true
    means x402 payment processing is operational.
  • semaphore.active
    near 
    semaphore.max
    means server is under heavy load (expect 503s).
GET https://agent.metengine.xyz/health
免费接口，无需支付，返回：
json
{
  "status": "ok | degraded",
  "service": "data-agent",
  "auth_mode": "x402",
  "clickhouse": { "status": "ok | down" },
  "postgres": { "status": "ok | down" },
  "redis": { "status": "ok | down" },
  "semaphore": {
    "active": "number",
    "waiting": "number",
    "max": 250,
    "timeouts_1m": "number"
  },
  "queries_1m": "object",
  "cache_1m": "object",
  "top_errors": "object",
  "facilitator": "boolean",
  "network": "mainnet"
}
  • status: "ok"
    表示所有后端服务正常
  • status: "degraded"
    表示至少一个后端服务异常，请检查各组件状态
  • facilitator: true
    表示x402支付处理正常运行
  • semaphore.active
    接近
    semaphore.max
    表示服务器负载过高（可能返回503）

Limitations

限制

What this API does NOT do:
  1. No trade execution. Read-only analytics. Cannot place orders on any platform.
  2. No real-time streaming. Request/response only. No WebSocket feeds.
  3. No historical backfill on demand. Data starts from when MetEngine began indexing each platform.
  4. No unrealized PnL for Hyperliquid. Only closed (realized) PnL is available.
  5. No mark-to-market for Meteora positions. Net value is deposits minus withdrawals, not current market value.
  6. No Polymarket order book data. Trades only, not open orders or liquidity depth.
  7. No custom scoring models. Wallet scores use MetEngine's proprietary models. Cannot be customized per agent.
  8. No cross-platform wallet linking. A Polygon address on Polymarket is not linked to a Solana address on Meteora even if controlled by the same entity.
  9. No token price feeds. This is not a price oracle. Market prices on Polymarket are implied probabilities (0-1).
  10. 63 endpoints only. If a path is not listed in this document, it does not exist.
本API不提供以下能力：
  1. 无交易执行能力，仅提供只读分析，无法在任何平台下单
  2. 无实时流推送，仅支持请求/响应模式，无WebSocket推送
  3. 不支持按需历史数据回灌，数据从MetEngine开始索引各平台的时间点开始
  4. 无Hyperliquid未实现PnL，仅提供已平仓（已实现）PnL
  5. 无Meteora持仓市值标记，净值为存款减去取款，非当前市场价值
  6. 无Polymarket订单簿数据，仅提供交易数据，不包含挂单或流动性深度
  7. 无自定义评分模型，钱包评分使用MetEngine的专有模型，无法按Agent需求自定义
  8. 无跨平台钱包关联，Polymarket上的Polygon地址和Meteora上的Solana地址即使属于同一实体也不会关联
  9. 无代币价格喂价，不是价格预言机，Polymarket上的市场价格为隐含概率（0-1）
  10. 仅提供63个接口，本文档未列出的路径不存在

Known Quirks

已知问题

Polymarket

Polymarket

  • /markets/opportunities
    frequently times out (504) under load. Use 
    /markets/high-conviction
    as fallback.
  • /wallets/top-performers?timeframe=7d
    may 503. Try 
    timeframe=24h
    but note the narrower window.
  • /trades/whales
    returns REDEEM trades (resolved market payouts) alongside real trades. Filter by 
    side=BUY
    or 
    side=SELL
    to exclude. REDEEMs have 
    price=1.00, side=REDEEM
    .
  • /markets/insiders
    sometimes times out. Use 
    /markets/trades
    filtered to the market as fallback.
  • Wallet addresses MUST be lowercase.
  • condition_id
    identifies a market. One condition_id maps to multiple 
    token_id
    values (one per outcome).
  • Price = implied probability (0 to 1). A price of 0.73 = 73% probability.
  • /markets/opportunities
    在高负载下频繁超时（504），使用
    /markets/high-conviction
    作为降级方案
  • /wallets/top-performers?timeframe=7d
    可能返回503，可尝试
    timeframe=24h
    但注意时间范围更窄
  • /trades/whales
    会同时返回REDEEM交易（已结算市场的payout）和真实交易，可通过
    side=BUY
    或
    side=SELL
    过滤剔除，REDEEM交易的
    price=1.00, side=REDEEM
  • /markets/insiders
    有时会超时，使用过滤到对应市场的
    /markets/trades
    作为降级方案
  • 钱包地址必须为小写
  • condition_id
    标识单个市场，一个condition_id对应多个
    token_id
    （每个结果对应一个）
  • 价格 = 隐含概率（0到1），价格0.73表示73%的概率

Hyperliquid

Hyperliquid

  • /hl/coins/trending?timeframe=24h
    and 
    /hl/smart-wallets/signals?timeframe=24h
    often return empty arrays. Default to 
    timeframe=7d
    .
  • /hl/trades/long-short-ratio
    may return all zeros. Reconstruct directional bias from 
    /hl/trades/whales
    .
  • /hl/traders/profile
    intermittently 500s. Use leaderboard + pnl-by-coin as fallback.
  • /hl/traders/pnl-by-coin
    shows realized (closed) PnL only. Unrealized PnL is not available.
  • Coin symbols are uppercase base only: 
    BTC
    , not 
    BTC-USDC
    .
  • Trader addresses are 0x-prefixed hex (case-insensitive).
  • closed_pnl
    is only non-zero on closing trades. Opening trades always have 
    closed_pnl = 0
    .
  • Smart wallet threshold: score >= 85 (stricter than Polymarket's 60).
  • /hl/coins/trending?timeframe=24h
    和
    /hl/smart-wallets/signals?timeframe=24h
    经常返回空数组，默认使用
    timeframe=7d
  • /hl/trades/long-short-ratio
    可能返回全零，从
    /hl/trades/whales
    重构多空偏向
  • /hl/traders/profile
    偶发500错误，使用排行榜 + 按币种PnL作为降级方案
  • /hl/traders/pnl-by-coin
    仅展示已平仓PnL，不提供未实现PnL
  • 币种符号仅为大写基础币种：
    BTC
    ，而非
    BTC-USDC
  • 交易者地址为0x前缀十六进制（大小写不敏感）
  • closed_pnl
    仅在平仓交易中非零，开仓交易的
    closed_pnl = 0
  • 聪明钱包阈值：评分 >= 85（比Polymarket的60更严格）

Meteora

Meteora

  • DAMM v2 pools frequently show implausible fee rates (30-50% of volume). This is an artifact of the anti-sniper fee scheduler on new token launches. Separate DAMM v2 from DLMM results and flag anomalies.
  • /meteora/pools/trending
    may have duplicate entries. Deduplicate by 
    pool_address
    .
  • /meteora/lps/top?sort_by=fees
    may 500. Use 
    sort_by=volume
    as fallback.
  • Some token mints show as "???" (unresolved). Check pair context for identification.
  • Addresses are Solana pubkeys (base58, case-sensitive).
  • DLMM uses 
    token_x
    /
    token_y
    and PascalCase event types (
    AddLiquidity
    , 
    RemoveLiquidity
    , 
    Swap
    , 
    ClaimFee
    ).
  • DAMM v2 uses 
    token_a
    /
    token_b
    and snake_case event types (
    add_liquidity
    , 
    remove_liquidity
    , 
    swap
    , 
    claim_fee
    ).
  • Position addresses only exist for DLMM, not DAMM v2.
  • DAMM v2资金池经常显示不合理的手续费率（占交易量的30-50%），这是新代币发行时的防抢跑手续费调度机制导致的，需分开处理DAMM v2和DLMM结果并标记异常
  • /meteora/pools/trending
    可能有重复条目，请按
    pool_address
    去重
  • /meteora/lps/top?sort_by=fees
    可能返回500，使用
    sort_by=volume
    作为降级方案
  • 部分代币mint显示为"???"（未解析），可通过交易对上下文识别
  • 地址为Solana公钥（base58，大小写敏感）
  • DLMM使用
    token_x
    /
    token_y
    和大驼峰事件类型（
    AddLiquidity
    、
    RemoveLiquidity
    、
    Swap
    、
    ClaimFee
    ）
  • DAMM v2使用
    token_a
    /
    token_b
    和蛇形事件类型（
    add_liquidity
    、
    remove_liquidity
    、
    swap
    、
    claim_fee
    ）
  • 仅DLMM有持仓地址，DAMM v2没有

Address Conventions

地址规范

PlatformFormatCase Sensitivity
Polymarket0x hex (Polygon)Must be lowercase
Hyperliquid0x hexCase-insensitive
MeteoraBase58 (Solana pubkey)Case-sensitive
平台格式大小写敏感性
Polymarket0x十六进制（Polygon）必须小写
Hyperliquid0x十六进制大小写不敏感
MeteoraBase58（Solana公钥）大小写敏感

Scoring Systems

评分系统

Polymarket Wallet Scores (0-100)

Polymarket钱包评分（0-100）

TierScoreMeaning
Elite>= 80Top-tier historically profitable
Smart60-79Consistently profitable, signal-worthy
Average40-59Mixed track record
Novice< 40New or losing traders
Smart money threshold: score >= 60. Dumb money threshold: score < 30.
层级评分含义
精英>= 80顶级历史盈利钱包
聪明60-79持续盈利，具备信号价值
平均40-59历史表现混合
新手< 40新用户或亏损交易者
聪明钱阈值：评分 >= 60，笨钱阈值：评分 < 30。

Hyperliquid Smart Scores (0-100)

Hyperliquid聪明评分（0-100）

score = min(log2(trade_count + 1) * 4, 40)             // Activity (max 40)
      + (winning_trades / max(closing_trades, 1)) * 40  // Win rate (max 40)
      + min(if(pnl > 0, log10(pnl + 1) * 4, 0), 20)    // Profitability (max 20)
Smart threshold: score >= 85.
score = min(log2(trade_count + 1) * 4, 40)             // 活跃度（最高40分）
      + (winning_trades / max(closing_trades, 1)) * 40  // 胜率（最高40分）
      + min(if(pnl > 0, log10(pnl + 1) * 4, 0), 20)    // 盈利能力（最高20分）
聪明阈值：评分 >= 85。

Meteora LP Smart Scores (0-100)

Meteora LP聪明评分（0-100）

win_ratio (0-35 pts) + volume (0-25 pts, log10-scaled) + avg_pnl% (0-30 pts) + experience (0-10 pts)
Minimum 3 closed positions required.
胜率（0-35分） + 交易量（0-25分，log10缩放） + 平均PnL百分比（0-30分） + 经验（0-10分）
至少需要3个已平仓持仓才会生成评分。