mcpField
M
metengine-data-agent

metengine-data-agent

github.com/sendaifunデータ・データベース130122 回インストール13 週間前に更新
リポジトリ

metengine-data-agent について

metengine-data-agentは、Polymarket、Hyperliquid、Meteoraのリアルタイムなスマートマネー分析を照会するエージェント向けスキルです。63のAPIエンドポイントを説明し、Solana上のx402でリクエストごとにUSDC決済するため、APIキーやアカウントは不要です。

主な機能

  1. 013つの対象プラットフォームを分析
  2. 02ウォレットと市場データの63エンドポイント
  3. 03Solana上のx402によるUSDC決済
  4. 04成功レスポンス後のみ決済
  5. 05セッションメモリと更新手順

活用シーン

  1. 01対象プラットフォーム間の資金フロー追跡
  2. 02ウォレット、ポジション、市場活動の分析
  3. 03APIアカウントなしで有料エンドポイントを照会
  4. 04セッション間で設定やエンドポイント記録を再利用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sendaifun/skills --skill metengine-data-agent

インストール後、Claude Code で/metengine-data-agentを入力して読み込まれたか確認します。

詳細

MetEngine データエージェント API

Polymarket、Hyperliquid、Meteora を対象としたリアルタイムのスマートマネー分析です。ウォレットスコアリング、インサイダー検知、資金フロー追跡、ポジション分析を網羅する 63 個のエンドポイントを提供します。Solana 上で USDC を使ってリクエストごとに支払えます。API キーもアカウントも不要で、導入時の手間もありません。


表示ルール

  • ウォレットアドレスやコントラクトアドレスを絶対に省略・短縮しないでください。 常にアドレス全体を表示してください(例:0x61276aba49117fd9299707d5d573652949d5c977。0x6127...c977 ではありません)。
  • これは、すべての Polymarket(0x 形式の 16 進数)、Hyperliquid(0x 形式の 16 進数)、Meteora(base58)、condition_ids、token_ids、プールアドレス、ポジションアドレス、トランザクションハッシュに適用されます。

スキルの自動更新

新しいエンドポイントの追加や料金の更新に伴い、このスキルファイルは変更される場合があります。最新の状態を保つため、毎週最新版をダウンロードしてください。

スキルファイルの最新版をダウンロード:

curl -sL https://www.metengine.xyz/skill.md -o ~/.claude/agents/metengine-data-agent.md

毎週の更新を自動化(cron):

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

クエリを実行する前にスキルのバージョンを確認(任意):

# 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

前回の更新から 7 日以上経過している場合、エージェントは新しいセッションの開始時に更新を確認することを推奨します。


セッションメモリ(重要 -- 最初にお読みください)

API 呼び出しを行う前に、必ず次の場所にメモリファイルがあるか確認してください。

~/.claude/agents/metengine-memory.md

このファイルはセッションをまたいで保持され、セットアップを省略してクエリを高速化するために必要な情報を保存します。メモリファイルが存在する場合は、最初に読み込んでください。 次の情報が記載されています。

  1. ウォレット設定 -- Solana キーペアのパス、公開アドレス、SOL/USDC 残高を確認済みかどうか
  2. パッケージの状態 -- @x402/core、@x402/svm、@solana/kit がすでにインストールされているか、およびインストール先
  3. クライアントの初期化 -- 前回のクエリ成功時に使用したコードスニペット(コピー&ペーストですぐに利用可能)
  4. エンドポイントの知見 -- 動作したエンドポイント、タイムアウトしたエンドポイント、使用した代替手段
  5. 料金キャッシュ -- 最後に取得した料金体系(料金セクション全体を読み直す手間を省けます)
メモリファイルの形式

次のテンプレートを使って ~/.claude/agents/metengine-memory.md を作成または更新してください。

# MetEngine Session Memory


## Last Updated
YYYY-MM-DD HH:MM UTC

## Skill Version
<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

## Packages
- installed: true/false
- install_dir: <path where bun add was run>
- packages: @x402/core, @x402/svm, @solana/kit
- bun_version: <version>

## Client Bootstrap

```typescript
// <paste the one-time setup + paidFetch function that worked>

エンドポイントの履歴

日付エンドポイント状態レイテンシUSDC の費用メモ

学習した代替手段

エンドポイント問題使用した代替手段

発生した問題


### 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

### How Memory Saves Tokens

| Without Memory | With Memory | Token Savings |
|---------------|-------------|---------------|
| Read full skill file (2400 lines) to find setup instructions | Skip to Client Bootstrap section | ~80% fewer setup tokens |
| Trial-and-error wallet detection | Read wallet path from memory | ~500 tokens saved |
| Install packages every session | Check `installed: true`, skip | ~200 tokens saved |
| Hit known-broken endpoint, get 504, try fallback | Check Fallbacks Learned, use fallback directly | ~1000 tokens saved per avoided failure |
| Re-discover quirks through errors | Check Quirks Encountered | ~300 tokens saved per quirk |

### Quick Start for Returning Agents

If `~/.claude/agents/metengine-memory.md` exists:

  1. メモリファイルを読み込む
  2. ウォレットとパッケージのセットアップが完了している場合: a. Client Bootstrap のコードをコピーする b. 必要なエンドポイントについて「学習した代替手段」を確認する c. API を直接呼び出す d. エンドポイントの履歴を更新する
  3. ウォレットまたはパッケージのセットアップが未完了の場合: a. 以下のオンボーディング手順に従う b. セットアップ後にメモリファイルを更新する

**First-time agents:** Follow the Onboarding Path below, then create the memory file.

### 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

---

## 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`.

---

## Payment Protocol: x402 on Solana Mainnet

Every paid endpoint uses a two-step handshake. No API keys. No accounts. Payment IS authentication.

### 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) | |


### 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.

### Headers

| Header | Direction | Description |
|--------|-----------|-------------|
| `PAYMENT-REQUIRED` | Response (402) | Encoded payment requirements |
| `X-PAYMENT-REQUIRED` | Response (402) | Duplicate of above for compatibility |
| `PAYMENT-SIGNATURE` | Request | Signed payment payload |
| `X-PAYMENT` | Request | Alternate payment header name |
| `PAYMENT-RESPONSE` | Response (200) | Settlement proof with tx hash |
| `X-PAYMENT-RESPONSE` | Response (200) | Duplicate of above for compatibility |

### Client Implementation (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 };
}
使用例
// 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 },
});
NPM の依存関係
bun add @x402/core @x402/svm @solana/kit

料金

すべての価格は、Solana Mainnet 上の USDC で表示されています。価格は、エンドポイントのティア、期間、上限、フィルターの使用状況に応じて変動します。

ティア別基本料金
ティア基本料金(USDC)説明
light$0.01シンプルな検索、検索、フィード
medium$0.02集計分析、トレンドデータ
heavy$0.05算出されたインテリジェンス、リーダーボード、スコアリング
whale$0.08複数エンティティの比較、複雑なスキャン
価格の調整要素

期間の乗数(基本料金に適用):

期間乗数
1h0.5x
4h0.7x
12h0.9x
24h / today1.0x
7d2.0x
30d3.0x
90d4.0x
365d / all5.0x

上限の乗数:price *= max(1, requested_limit / default_limit)

フィルター割引(スキャンコストを削減):

フィルター割引適用されるエンドポイント
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.7xpool_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:includes の両方を指定した場合は 1.0x、片方を指定した場合は 0.7x、どちらも指定しない場合は 0.4x
  • wallets/top-performers で category を指定しない場合:2.0x のペナルティ

上限:

  • /api/v1/markets/opportunities:最大 $0.15
  • /api/v1/wallets/copy-traders:最大 $0.12

全体の範囲:リクエストあたり最低 $0.01、最高 $0.20 です。

機械可読な料金情報
GET https://agent.metengine.xyz/api/v1/pricing

すべてのティア、ルート、乗数、割引、特別ルールを含む料金体系全体を JSON で返します。無料のエンドポイントです。支払いは不要です。


機能マニフェスト

Polymarket(27 個のエンドポイント)
#MethodPathTier説明
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市場別の損益内訳
20POST/api/v1/wallets/comparewhale2~5 個のウォレットを並べて比較
21POST/api/v1/wallets/copy-traderswhale対象ウォレットをコピーするウォレットを検出
22GET/api/v1/wallets/top-performersheavy損益、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 エンドポイント)
#MethodPathTierDescription
28GET/api/v1/hl/platform/statslightプラットフォーム全体の統計
29GET/api/v1/hl/coins/trendingmediumアクティビティ別のトレンドコイン
30GET/api/v1/hl/coins/listlight7日間の統計情報付き全取引コイン
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連勝・連敗情報付きの日次損益時系列
36POST/api/v1/hl/traders/pnl-by-coinmediumコイン別の損益内訳(決済済み損益のみ)
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 エンドポイント)
#MethodPathTierDescription
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/profileheavyLP の詳細情報
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 アクティビティが最も高いプール

エンドポイント完全リファレンス

レスポンスエンベロープ

すべての 200 レスポンスは次の形式です:{ "data": <payload> }

すべてのエラーレスポンスは次の形式です:{ "error": "<message>" }。任意の "reason" フィールドを含む場合があります。


POLYMARKET
1. GET /api/v1/markets/trending

取引量が急増しているトレンド市場です。

パラメーター(クエリ文字列):

ParamTypeDefaultValuesRequired
timeframestring24h1h, 4h, 12h, 24h, 7dno
categorystring-any valid categoryno
sort_bystringvolume_spikevolume_spike, trade_count, smart_money_inflowno
limitinteger201-100no

レスポンススキーマ:

{
  "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

キーワード、カテゴリ、ステータスで市場を検索します。query パラメーターには Polymarket の URL を指定できます。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
querystring-キーワードまたは Polymarket の URLいいえ
categorystring-有効なカテゴリいいえ
statusstringactiveactive, closing_soon, resolvedいいえ
has_smart_money_signalboolean-true, falseいいえ
sort_bystringrelevanceend_date, volume, relevanceいいえ
limitinteger201-100いいえ

レスポンススキーマ:

{
  "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

アクティビティ統計を含むすべてのカテゴリを一覧表示します。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
include_statsbooleantruetrue, falseいいえ
timeframestring24h24h, 7dいいえ

レスポンススキーマ:

{
  "data": [
    {
      "name": "string",
      "active_markets": "number",
      "period_volume": "number",
      "period_trades": "number",
      "unique_traders": "number"
    }
  ]
}
4. GET /api/v1/platform/stats

プラットフォーム全体の集計統計です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframestring24h24h, 7d, 30dいいえ

レスポンススキーマ:

{
  "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

特定の市場に関するスマートマネーの詳細なインテリジェンスレポートです。

リクエストボディ(JSON):

フィールド型デフォルト値必須
condition_idstring--はい
top_n_walletsinteger101-50いいえ

レスポンススキーマ:

{
  "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

OHLCV 価格/確率の時系列データです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
condition_idstring--はい
timeframestring7d1h, 4h, 12h, 24h, 7d, 30dいいえ
bucket_sizestring1h5m, 15m, 1h, 4h, 12h, 1dいいえ

レスポンススキーマ:

{
  "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

スマートマネーのオーバーレイ付きセンチメント時系列データです。

リクエストボディ(JSON):

フィールド型デフォルト値必須
condition_idstring--はい
timeframestring7d24h, 7d, 30dいいえ
bucket_sizestring4h1h, 4h, 12h, 1dいいえ

レスポンススキーマ:

{
  "data": {
    "condition_id": "string",
    "question": "string",
    "overall_sentiment": "object",
    "by_outcome": "object",
    "time_series": "array",
    "momentum": "object"
  }
}
8. POST /api/v1/markets/participants

スコアリングティア別の参加者概要です。

リクエストボディ(JSON):

フィールド型デフォルト値必須
condition_idstring--はい

レスポンススキーマ:

{
  "data": {
    "condition_id": "string",
    "question": "string",
    "total_wallets": "number",
    "total_usdc": "number",
    "by_outcome": "object",
    "tier_distribution": "object"
  }
}
9. POST /api/v1/markets/insiders

7 つのシグナルによる行動スコアリングを使用したインサイダーパターンの検出です。

リクエストボディ(JSON):

フィールド型デフォルト値必須
condition_idstring--はい
limitinteger251-100いいえ
min_scoreinteger200-100いいえ

レスポンススキーマ:

{
  "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

市場の取引を時系列順に表示するフィードです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
condition_idstring--はい
timeframestring24h1h, 4h, 12h, 24h, 7d, 30dいいえ
sidestring-BUY, SELLいいえ
min_usdcnumber0>= 0いいえ
smart_money_onlybooleanfalsetrue, falseいいえ
limitinteger1001-500いいえ

レスポンススキーマ:

{
  "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

ウォレットの重複に基づく関連市場です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
condition_idstring--はい
limitinteger101-50いいえ

レスポンススキーマ:

{
  "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

スマートマネーと価格の見方が食い違っている市場です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
min_signal_strength文字列moderateweak, moderate, strongいいえ
category文字列-有効なカテゴリーいいえ
closing_within_hours整数-最大 720いいえ
min_smart_wallets整数3>= 1いいえ
limit整数201-100いいえ

レスポンススキーマ:

{
  "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

確信度の高いスマートマネーの賭けです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
category文字列-有効なカテゴリーいいえ
min_smart_wallets整数5>= 1いいえ
min_avg_score整数650-100いいえ
limit整数201-100いいえ

レスポンススキーマ:

{
  "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

カテゴリー別の資金フロー(セクターローテーション)です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframe文字列7d24h, 7d, 30dいいえ
smart_money_onlyブール値falsetrue, falseいいえ
top_n_categories整数201-50いいえ

レスポンススキーマ:

{
  "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

大口のクジラ取引です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
min_usdc数値10000>= 1いいえ
timeframe文字列24h1h, 4h, 12h, 24h, 7d, 30dいいえ
condition_id文字列--いいえ
category文字列-有効なカテゴリーいいえ
side文字列-BUY, SELLいいえ
smart_money_onlyブール値falsetrue, falseいいえ
limit整数501-200いいえ

レスポンススキーマ:

{
  "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 取引(解決済み市場の支払い)を返します。side=BUY または side=SELL でフィルターすると、REDEEM 取引を除外できます。REDEEM 取引の price=1.00、side=REDEEM です。

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

カテゴリー、時間帯、または曜日ごとの出来高分布です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframe文字列24h24h, 7d, 30dいいえ
group_by文字列categorycategory, hour_of_day, day_of_weekいいえ
smart_money_onlyブール値falsetrue, falseいいえ

レスポンススキーマ:

{
  "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

ウォレットの詳細な調査情報です。

リクエストボディ(JSON):

フィールド型デフォルト値必須
wallet文字列-小文字のアドレスはい
include_positionsブール値truetrue, falseいいえ
include_tradesブール値truetrue, falseいいえ
trades_limit整数501-500いいえ

レスポンススキーマ:

{
  "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

ウォレットの最近の取引アクティビティです。

リクエストボディ(JSON):

フィールド型デフォルト値必須
wallet文字列-小文字のアドレスはい
timeframe文字列24h1h, 4h, 24h, 7d, 30dいいえ
category文字列-有効なカテゴリーいいえ
min_usdc数値0>= 0いいえ
limit整数1001-500いいえ

レスポンススキーマ:

{
  "data": {
    "wallet": "string",
    "wallet_score": "number",
    "wallet_tags": ["string"],
    "period_summary": "object",
    "trades": "array"
  }
}
19. POST /api/v1/wallets/pnl-breakdown

市場ごとの損益の内訳です。

リクエストボディ(JSON):

フィールド型デフォルト値必須
wallet文字列-小文字のアドレスはい
timeframe文字列90d7d, 30d, 90d, allいいえ
limit整数501-200いいえ

レスポンススキーマ:

{
  "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

2~5 個のウォレットを並べて比較します。

リクエスト本文(JSON):

フィールド型デフォルト値必須
walletsstring[]-小文字のアドレス 2~5 個はい
include_shared_positionsbooleantruetrue, falseいいえ

レスポンススキーマ:

{
  "data": {
    "wallets": "array of wallet profiles",
    "comparison_winners": "object",
    "category_overlap": "object",
    "shared_positions": "array"
  }
}

料金に関する注意: コストはウォレット数に応じて増加します:base * wallets.length / 2。

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

対象のウォレットをコピーしているウォレットを検出します。

リクエスト本文(JSON):

フィールド型デフォルト値必須
walletstring-小文字のアドレスはい
max_lag_minutesinteger601-1440いいえ
timeframestring7d24h, 7d, 30dいいえ
min_overlap_tradesinteger3>= 1いいえ
limitinteger201-100いいえ

レスポンススキーマ:

{
  "data": [
    {
      "wallet": "string",
      "overlap_trades": "number",
      "avg_lag_seconds": "number",
      "copied_tokens": "array",
      "wallet_score": "number"
    }
  ]
}
22. GET /api/v1/wallets/top-performers

リーダーボードです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframestring7dtoday, 24h, 7d, 30d, 90d, 365dいいえ
categorystring-有効なカテゴリーいいえ
metricstringpnlpnl, roi, sharpe, win_rate, volumeいいえ
min_tradesinteger5>= 1いいえ
limitinteger251-100いいえ

レスポンススキーマ:

{
  "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

特定のカテゴリーで上位のウォレットです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
categorystring-有効なカテゴリーはい
min_category_tradesinteger10>= 1いいえ
sort_bystringcategory_sharpecategory_sharpe, category_pnl, category_volumeいいえ
limitinteger251-100いいえ

レスポンススキーマ:

{
  "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

スマートマネーの正確性を含む、決着済みのマーケットです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
categorystring-有効なカテゴリーいいえ
querystring-キーワードいいえ
sort_bystringresolved_recentlyresolved_recently, volume, smart_money_accuracyいいえ
limitinteger251-100いいえ

レスポンススキーマ:

{
  "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

後にトレンドとなるマーケットで早期に取引するウォレットです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
days_backinteger301-90いいえ
min_days_earlyinteger71-60いいえ
min_bet_usdcnumber100>= 0いいえ
limitinteger251-100いいえ

レスポンススキーマ:

{
  "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

マーケットにおける低スコアトレーダーのポジション(逆張り指標)です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
condition_idstring--はい
max_scoreinteger300-100いいえ
min_tradesinteger5>= 1いいえ
limitinteger501-200いいえ

レスポンススキーマ:

{
  "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

行動スコアに基づく、全体のインサイダー候補です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
limitinteger501-200いいえ
min_scoreinteger500-100いいえ
max_wallet_age_daysinteger601-90いいえ

レスポンススキーマ:

{
  "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
28. GET /api/v1/hl/platform/stats

プラットフォームの集計統計です。パラメーターはありません。

レスポンススキーマ:

{
  "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

アクティビティ別のトレンドコインです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframestring24h1h, 4h, 12h, 24h, 7dいいえ
limitinteger201-100いいえ

レスポンススキーマ:

{
  "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

7d 統計付きの、取引対象となるすべてのコインです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
limitinteger1001-500いいえ

レスポンススキーマ:

{
  "data": [
    {
      "coin": "string",
      "volume_usd": "number",
      "trade_count": "number",
      "unique_traders": "number"
    }
  ]
}
31. GET /api/v1/hl/coins/volume-heatmap

コイン別、時間別の取引量です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframestring24h24h, 7dいいえ
limitinteger201-50いいえ

レスポンススキーマ:

{
  "data": [
    {
      "coin": "string",
      "bucket": "string",
      "volume_usd": "number",
      "trade_count": "number",
      "smart_volume_usd": "number"
    }
  ]
}
32. GET /api/v1/hl/traders/leaderboard

ランキング形式のトレーダーリーダーボードです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframestringall1d, 7d, 30d, allいいえ
sort_bystringpnlpnl, roi, win_rate, volumeいいえ
sort_orderstringdescdesc, ascいいえ
min_tradesinteger10>= 1いいえ
limitinteger251-100いいえ

レスポンススキーマ:

{
  "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

トレーダーの詳細なプロフィールです。

リクエストボディ(JSON):

フィールド型デフォルト値必須
traderstring-0x addressはい
daysinteger301-365いいえ
trades_limitinteger501-500いいえ

レスポンススキーマ:

{
  "data": {
    "trader": "string",
    "stats": "object",
    "coin_breakdown": "array",
    "daily_pnl": "array",
    "recent_trades": "array"
  }
}

既知の問題: 断続的に 500 エラーが発生します。代替手段:リーダーボードと pnl-by-coin を使用してください。

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

2~5 人のトレーダーを比較します。

リクエストボディ(JSON):

フィールド型デフォルト値必須
tradersstring[]-2-5 0x addressesはい

レスポンススキーマ:

{
  "data": {
    "traders": "array of trader profiles",
    "shared_coins": "array",
    "comparison_winners": "object"
  }
}

料金に関する注意: 料金はトレーダー数に応じて増加します:base * traders.length / 2。

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

連勝・連敗記録付きの日次 PnL 時系列データです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
traderstring-0x addressはい
daysinteger301-365いいえ

レスポンススキーマ:

{
  "data": [
    {
      "date": "string",
      "pnl": "number",
      "volume": "number",
      "trades": "number",
      "cumulative_pnl": "number",
      "streak": "number"
    }
  ]
}
36. POST /api/v1/hl/traders/pnl-by-coin

コイン別の PnL 内訳です。実現済み(決済済み)の PnL のみを表示します。

リクエストボディ(JSON):

フィールド型デフォルト値必須
traderstring-0x addressはい
daysinteger901-365いいえ

レスポンススキーマ:

{
  "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

新たに大口取引を行うウォレット(新規アカウントを作成した経験豊富なトレーダー、機関投資家のトレーディングデスク、または内部関係者)です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
max_wallet_age_daysinteger141-90いいえ
min_volumenumber100000>= 0いいえ
min_pnlnumber0anyいいえ
limitinteger251-100いいえ

レスポンススキーマ:

{
  "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

大口取引です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
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いいえ

レスポンススキーマ:

{
  "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

コインの時系列順取引フィードです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
coinstring-大文字のシンボルはい
limitinteger1001-500いいえ

レスポンススキーマ:

{
  "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

ロング/ショート出来高比率の時系列データです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
coinstring-大文字のシンボルはい
timeframestring7d24h, 7d, 30dいいえ
bucket_sizestring4h1h, 4h, 12h, 1dいいえ

レスポンススキーマ:

{
  "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

スマートウォレットの一覧です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
sort_bystringscorescore, pnl, volumeいいえ
limitinteger501-200いいえ

レスポンススキーマ:

{
  "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

スマートウォレットの最近の取引です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframestring24h1h, 4h, 12h, 24h, 7dいいえ
min_scoreinteger600-100いいえ
limitinteger1001-500いいえ

レスポンススキーマ:

{
  "data": {
    "period_summary": "object",
    "trades": "array"
  }
}
43. GET /api/v1/hl/smart-wallets/signals

コインごとに集約された方向性シグナルです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
timeframestring24h6h, 12h, 24h, 7dいいえ
min_scoreinteger600-100いいえ
limitinteger201-50いいえ

レスポンススキーマ:

{
  "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

スマートポジションを含むロング/ショートの圧力です。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
coinsstring-カンマ区切り(デフォルトは上位 10 件)いいえ
trades_limitinteger201-100いいえ

レスポンススキーマ:

{
  "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

すべてのコインを対象とした圧力の概要です。パラメーターはありません。

レスポンススキーマ:

{
  "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
46. GET /api/v1/meteora/pools/trending

出来高の急増に基づくトレンドプールです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
pool_typestringalldlmm, damm_v2, allいいえ
timeframestring24h24h, 7dいいえ
limitinteger201-100いいえ

レスポンススキーマ:

{
  "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

出来高、手数料、または LP 数に基づく上位プールです。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
pool_typestringalldlmm, damm_v2, allいいえ
sort_bystringvolumevolume, lp_count, events, feesいいえ
timeframestring7d24h, 7d, 30dいいえ
limitinteger201-100いいえ

レスポンススキーマ:

{
  "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

アドレスまたはトークン名でプールを検索します。

パラメーター(クエリ文字列):

ParamTypeDefaultValuesRequired
querystring-プールアドレスまたはトークン名はい
pool_typestringalldlmm, damm_v2, allいいえ
limitinteger101-50いいえ

レスポンススキーマ:

{
  "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

プールの詳細情報です。

パラメーター(クエリ文字列):

ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyはい
pool_typestring-dlmm, damm_v2(省略時は自動検出)いいえ

レスポンススキーマ:

{
  "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

出来高の時系列データです。

パラメーター(クエリ文字列):

ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyはい
pool_typestring-dlmm, damm_v2(省略時は自動検出)いいえ
timeframestring7d24h, 7d, 30dいいえ
bucket_sizestring4h1h, 4h, 1dいいえ

レスポンススキーマ:

{
  "data": [
    {
      "bucket": "string",
      "volume_usd": "number",
      "event_count": "number",
      "action_breakdown": "object"
    }
  ]
}
51. GET /api/v1/meteora/pools/events

時系列順のイベントフィードです。

パラメーター(クエリ文字列):

ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyはい
pool_typestring-dlmm, damm_v2(省略時は自動検出)いいえ
limitinteger1001-500いいえ

レスポンススキーマ:

{
  "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

手数料請求の分析です。

パラメーター(クエリ文字列):

ParamTypeDefaultValuesRequired
pool_addressstring-Solana pubkeyはい
pool_typestring-dlmm, damm_v2(省略時は自動検出)いいえ
timeframestring7d24h, 7d, 30dいいえ

レスポンススキーマ:

{
  "data": {
    "pool_address": "string",
    "total_fees_claimed": "number",
    "unique_claimers": "number",
    "time_series": "array",
    "top_claimers": "array"
  }
}
53. GET /api/v1/meteora/lps/top

上位LPのランキングです。

パラメーター(クエリ文字列):

ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allいいえ
sort_bystringvolumevolume, pool_count, eventsいいえ
timeframestring30d7d, 30dいいえ
limitinteger251-100いいえ

レスポンススキーマ:

{
  "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

LPの詳細なプロファイルです。

リクエストボディ(JSON):

FieldTypeDefaultValuesRequired
ownerstring-Solana pubkeyはい
pool_typestringalldlmm, damm_v2, allいいえ
events_limitinteger501-500いいえ

レスポンススキーマ:

{
  "data": {
    "owner": "string",
    "summary": "object",
    "pool_breakdown": "array",
    "recent_events": "array"
  }
}
55. GET /api/v1/meteora/lps/whales

大口LPのイベントです。

パラメーター(クエリ文字列):

ParamTypeDefaultValuesRequired
pool_typestringalldlmm, damm_v2, allいいえ
min_usdnumber10000>= 1いいえ
timeframestring24h24h, 7d, 30dいいえ
limitinteger501-200いいえ

レスポンススキーマ:

{
  "data": [
    {
      "owner": "string",
      "pool_address": "string",
      "pool_type": "string",
      "event_type": "string",
      "usd_total": "number",
      "timestamp": "string"
    }
  ]
}
56. POST /api/v1/meteora/lps/compare

2~5件のLPを比較します。

リクエストボディ(JSON):

FieldTypeDefaultValuesRequired
ownersstring[]-2-5件のSolana pubkeyはい
pool_typestringalldlmm, damm_v2, allいいえ

レスポンススキーマ:

{
  "data": {
    "lps": "array of LP profiles",
    "shared_pools": "array",
    "comparison_winners": "object"
  }
}

料金に関する注意: 料金はLP数に応じて増加します:base * owners.length / 2。

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

アクティブな LP ポジション。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
pool_addressstring-Solana pubkeyいいえ
ownerstring-Solana pubkeyいいえ
pool_typestringalldlmm, damm_v2, allいいえ
limitinteger501-200いいえ

レスポンススキーマ:

{
  "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

ポジションのイベント履歴(DLMM のみ)。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
position_addressstring--はい

レスポンススキーマ:

{
  "data": {
    "position_address": "string",
    "events": [
      {
        "event_type": "string",
        "usd_total": "number",
        "timestamp": "string",
        "tx_id": "string"
      }
    ]
  }
}
59. GET /api/v1/meteora/platform/stats

プラットフォーム全体の統計情報。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
pool_typestringalldlmm, damm_v2, allいいえ

レスポンススキーマ:

{
  "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

アクション/時間別の取引量。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
pool_typestringalldlmm, damm_v2, allいいえ
timeframestring24h24h, 7dいいえ

レスポンススキーマ:

{
  "data": [
    {
      "action": "string",
      "bucket": "string",
      "pool_type": "string",
      "volume_usd": "number",
      "event_count": "number"
    }
  ]
}
61. GET /api/v1/meteora/platform/metengine-share

MetEngine のルーティングシェア。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
pool_typestringalldlmm, damm_v2, allいいえ
timeframestring7d24h, 7d, 30dいいえ

レスポンススキーマ:

{
  "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

トークン別の DCA 蓄積圧力。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
tokenstring-特定の mint アドレスいいえ
timeframestring1h1m, 5m, 30m, 1h, 6h, 24hいいえ

レスポンススキーマ(単一トークン):

{
  "data": {
    "tokenMint": "string",
    "timeframe": "string",
    "buyVolume": "number",
    "sellVolume": "number",
    "netPressure": "number",
    "score": "number"
  }
}

レスポンススキーマ(すべてのトークン、token を省略した場合):

{
  "data": {
    "timeframe": "string",
    "tokens": "array",
    "lastUpdated": "string"
  }
}
63. GET /api/v1/meteora/pools/smart-wallet

スマートウォレットによる LP アクティビティが最も活発なプール。

パラメーター(クエリ文字列):

パラメーター型デフォルト値必須
pool_typestringalldlmm, damm_v2, allいいえ
limitinteger201-100いいえ
timeframestring7d24h, 7d, 30dいいえ

レスポンススキーマ:

{
  "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"
      }
    ]
  }
}

自己計算との比較

この API を自分で計算せずに利用する理由

1. 独自のスコアリング済みデータセット。 MetEngine は、3 つすべてのプラットフォームにわたるウォレットスコアリングモデルを維持しています(Polymarket の 0〜100 の複合スコア、Hyperliquid の 0〜100 のスマートスコア、Meteora の LP スマートスコア)。これらのスコアは、数十億件の過去の取引、決済済みポジション、行動パターンに基づいて算出されます。エージェントが同等のものを用意するには、(a)5 億 7,400 万件を超える Polymarket の取引をインデックス化し、(b)スコアリングパイプラインを構築・維持し、(c)数百万のウォレットのスコアを保存・更新する必要があります。自前で計算する場合のコスト:数週間のエンジニアリング作業と継続的なインフラ運用。

2. 事前集計済みのマテリアライズドビュー。 5 億 7,400 万件を超える取引行のスキャンが必要なクエリ(カテゴリ別の資金フロー、上位パフォーマー、インサイダーの検出)は、事前集計済みの SummingMergeTree テーブルを使って実行されます。生の ClickHouse 取引テーブルをスキャンすると、30〜60 秒かかり、コンピューティング費用は 0.50〜2.00 ドルです。API なら、0.01〜0.08 ドルで 1〜5 秒以内に結果を返します。

3. クロスプラットフォームのインテリジェンス。 インサイダーの検出には、7 つのシグナルを用いた行動スコアリングシステムを使用します。スマートマネーのコンセンサスでは、スコアリング済みウォレットと市場価格を比較します。資金フローでは、すべてのカテゴリにわたるセクターローテーションを追跡します。生のオンチェーンデータからこれらを構築するには、複数のチェーンのインデックス化、市場メタデータの維持、継続的なスコアリングパイプラインの実行が必要です。

4. リアルタイムのオンチェーンデータ。 API は Polymarket(Polygon)、Hyperliquid(L1)、Meteora(Solana)の取引データを 1 分未満の遅延でインデックス化します。エージェントが同等のものを用意するには、3 つのチェーンの RPC ノード、イベントの解析、データベースインフラが必要です。

一般的なワークフロー(Polymarket の市場を分析する場合)のコスト比較:

手順自前で計算MetEngine API
市場を検索Polymarket のフロントエンドをスクレイピングGET /markets/search($0.01)
スマートマネーのコンセンサスを取得すべての取引をインデックス化し、ウォレットをスコアリングして集計POST /markets/intelligence($0.05)
価格履歴を取得オンチェーンイベントを解析し、OHLCV を構築GET /markets/price-history($0.01)
インサイダーのパターンを検出7 シグナルの検出パイプラインを構築POST /markets/insiders($0.05)
合計数時間の計算時間とインフラ$0.12、約 10 秒

パフォーマンス

指標値
p50 レイテンシ800ms
p95 レイテンシ3s
p99 レイテンシ8s
ハンドラーのタイムアウト60s(タイムアウト時に課金なし)
有料リクエストの最大同時実行数50
支払い検証のタイムアウト5s
レート制限(未払いの 402 リクエスト)IP ベース、緩やか
データの鮮度
プラットフォーム鮮度
Polymarket の取引1 分未満(継続的にインデックス化)
Polymarket のウォレットスコア毎日再計算
Hyperliquid の取引1 分未満
Hyperliquid のスマートスコア継続的に更新(数式ベース)
Meteora のイベント1 分未満
Meteora の LP スコア毎日再計算

エラー処理

HTTP ステータスコード
コード意味エージェントの対応
200成功。データは { "data": ... } に含まれます。決済証明は PAYMENT-RESPONSE ヘッダーに含まれます。データを処理する
400不正なリクエスト(無効なパラメーター、不正な形式の支払いヘッダー)リクエストパラメーターを修正する
402支払いが必要(初回のリクエスト)、または支払いの検証に失敗支払いに署名して再送信するか、支払いの有効性を確認する
404エンドポイントが見つからないこのドキュメントでエンドポイントのパスを確認する
429レート制限を超過待機して再試行する
500内部サーバーエラー1 回再試行し、その後フォールバックエンドポイントを試す
502支払いの検証に失敗(ファシリテーターのエラー)再試行する
503サーバーが過負荷、または支払いサービスが利用不可Retry-After ヘッダーを確認し、指定された時間が経過してから再試行する
504クエリの実行がタイムアウトしました。課金はありません。パラメーターの範囲を狭めて再試行するか、フォールバックエンドポイントを使用する
エラーレスポンス形式
{
  "error": "Human-readable error message",
  "reason": "Optional machine-readable reason (on 402 verification failures)"
}
決済に関する例外ケース
ヘッダー意味
X-Payment-Settlement: failedクエリは成功しましたが、決済に失敗しました。データは返されますが、課金はされません。まれな例外ケースです。
200 で PAYMENT-RESPONSE ヘッダーがない決済が試行されていません(通常のフローでは発生しないはずです)。
フォールバック戦略

エンドポイントが失敗した場合は、次の代替手段を使用してください。

失敗したエンドポイントフォールバック
/markets/opportunities (504)/markets/high-conviction
/wallets/top-performers (7d で 503)timeframe=24h を試す
/markets/insiders (タイムアウト)market フィルターを指定して /markets/trades
/hl/coins/trending (24h で空)timeframe=7d を使用
/hl/smart-wallets/signals (24h で空)timeframe=7d を使用
/hl/trades/long-short-ratio (すべてゼロ)/hl/trades/whales を side 別に集計して再構成
/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 を使用

ヘルスチェック

GET https://agent.metengine.xyz/health

無料です。支払いは不要です。次の情報を返します。

{
  "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" は、少なくとも 1 つのバックエンドが停止していることを示します。各コンポーネントのステータスを確認してください。
  • facilitator: true は、x402 の支払い処理が稼働していることを示します。
  • semaphore.active が semaphore.max に近い場合、サーバーに高負荷がかかっています(503 が発生する可能性があります)。

制限事項

この API でできないこと:

  1. 取引の実行はできません。 読み取り専用の分析機能です。いずれのプラットフォームでも注文を出すことはできません。
  2. リアルタイムのストリーミングには対応していません。 リクエストとレスポンスのみです。WebSocket フィードはありません。
  3. 過去データをオンデマンドで遡って取得することはできません。 データは、MetEngine が各プラットフォームのインデックス作成を開始した時点から利用できます。
  4. Hyperliquid の未実現損益には対応していません。 利用できるのは、決済済み(実現)損益のみです。
  5. Meteora ポジションの時価評価には対応していません。 純価値は入金額から出金額を差し引いたものであり、現在の市場価値ではありません。
  6. Polymarket のオーダーブックデータはありません。 取引のみで、未約定注文や流動性の深さは含まれません。
  7. カスタムのスコアリングモデルには対応していません。 ウォレットスコアには MetEngine 独自のモデルが使用されます。エージェントごとのカスタマイズはできません。
  8. プラットフォーム間のウォレット紐付けには対応していません。 同じ主体が管理している場合でも、Polymarket の Polygon アドレスと Meteora の Solana アドレスは紐付けられません。
  9. トークン価格フィードはありません。 価格オラクルではありません。Polymarket の市場価格は、暗示確率(0-1)です。
  10. エンドポイントは 63 個のみです。 このドキュメントに記載されていないパスは存在しません。

既知の注意点

Polymarket
  • /markets/opportunities は、負荷が高いと頻繁にタイムアウトします(504)。フォールバックとして /markets/high-conviction を使用してください。
  • /wallets/top-performers?timeframe=7d は 503 を返すことがあります。timeframe=24h を試してください。ただし、対象期間が短くなる点に注意してください。
  • /trades/whales は、通常の取引とともに REDEEM 取引(解決済み市場の払い戻し)を返します。除外するには、side=BUY または side=SELL でフィルターしてください。REDEEM は price=1.00, side=REDEEM です。
  • /markets/insiders はタイムアウトすることがあります。フォールバックとして、対象市場でフィルターした /markets/trades を使用してください。
  • ウォレットアドレスは必ず小文字にしてください。
  • condition_id は市場を識別します。1 つの condition_id に複数の token_id 値(結果ごとに 1 つ)が対応します。
  • 価格は暗示確率(0 から 1)です。価格が 0.73 の場合、確率は 73% です。
Hyperliquid
  • /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-by-coin を使用してください。
  • /hl/traders/pnl-by-coin に表示されるのは、実現(決済済み)損益のみです。未実現損益は利用できません。
  • コインのシンボルは大文字のベース部分のみです。BTC-USDC ではなく BTC です。
  • トレーダーのアドレスは 0x で始まる 16 進数です(大文字と小文字は区別されません)。
  • closed_pnl がゼロ以外になるのは決済取引のみです。新規取引では常に closed_pnl = 0 です。
  • スマートウォレットのしきい値:スコア >= 85(Polymarket の 60 より厳しい設定です)。
Meteora
  • DAMM v2 プールでは、もっともらしくない手数料率(出来高の30~50%)が頻繁に表示されます。これは、新規トークンのローンチ時に適用されるスナイパー対策の手数料スケジューラーによるものです。DAMM v2 と DLMM の結果を分け、異常値にフラグを付けてください。
  • /meteora/pools/trending には重複したエントリーが含まれる場合があります。pool_address で重複を除去してください。
  • /meteora/lps/top?sort_by=fees は500エラーになる場合があります。フォールバックとして sort_by=volume を使用してください。
  • 一部のトークンミントは「???」(未解決)と表示されます。識別するにはペアのコンテキストを確認してください。
  • アドレスは 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 にはありません。

アドレスの規則

プラットフォーム形式大文字と小文字の区別
Polymarket0x hex(Polygon)小文字である必要があります
Hyperliquid0x hex大文字と小文字を区別しません
MeteoraBase58(Solana の公開鍵)大文字と小文字を区別します

スコアリングシステム

Polymarket ウォレットスコア(0-100)
ティアスコア意味
エリート>= 80過去の収益性が最上位
スマート60-79一貫して利益を上げており、シグナルとして有用
平均40-59実績にばらつきがある
初心者< 40新規または損失を出しているトレーダー

スマートマネーのしきい値:スコア >= 60。ダムマネーのしきい値:スコア < 30。

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)

スマートのしきい値:スコア >= 85。

Meteora LP スマートスコア(0-100)
win_ratio (0-35 pts) + volume (0-25 pts, log10-scaled) + avg_pnl% (0-30 pts) + experience (0-10 pts)

クローズ済みポジションが最低3件必要です。

コメント