metengine-data-agent について
metengine-data-agentは、Polymarket、Hyperliquid、Meteoraのリアルタイムなスマートマネー分析を照会するエージェント向けスキルです。63のAPIエンドポイントを説明し、Solana上のx402でリクエストごとにUSDC決済するため、APIキーやアカウントは不要です。
主な機能
- 013つの対象プラットフォームを分析
- 02ウォレットと市場データの63エンドポイント
- 03Solana上のx402によるUSDC決済
- 04成功レスポンス後のみ決済
- 05セッションメモリと更新手順
活用シーン
- 01対象プラットフォーム間の資金フロー追跡
- 02ウォレット、ポジション、市場活動の分析
- 03APIアカウントなしで有料エンドポイントを照会
- 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
このファイルはセッションをまたいで保持され、セットアップを省略してクエリを高速化するために必要な情報を保存します。メモリファイルが存在する場合は、最初に読み込んでください。 次の情報が記載されています。
- ウォレット設定 -- Solana キーペアのパス、公開アドレス、SOL/USDC 残高を確認済みかどうか
- パッケージの状態 --
@x402/core、@x402/svm、@solana/kitがすでにインストールされているか、およびインストール先 - クライアントの初期化 -- 前回のクエリ成功時に使用したコードスニペット(コピー&ペーストですぐに利用可能)
- エンドポイントの知見 -- 動作したエンドポイント、タイムアウトしたエンドポイント、使用した代替手段
- 料金キャッシュ -- 最後に取得した料金体系(料金セクション全体を読み直す手間を省けます)
メモリファイルの形式
次のテンプレートを使って ~/.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:
- メモリファイルを読み込む
- ウォレットとパッケージのセットアップが完了している場合: a. Client Bootstrap のコードをコピーする b. 必要なエンドポイントについて「学習した代替手段」を確認する c. API を直接呼び出す d. エンドポイントの履歴を更新する
- ウォレットまたはパッケージのセットアップが未完了の場合: 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 | 複数エンティティの比較、複雑なスキャン |
価格の調整要素
期間の乗数(基本料金に適用):
| 期間 | 乗数 |
|---|---|
| 1h | 0.5x |
| 4h | 0.7x |
| 12h | 0.9x |
| 24h / today | 1.0x |
| 7d | 2.0x |
| 30d | 3.0x |
| 90d | 4.0x |
| 365d / all | 5.0x |
上限の乗数:price *= max(1, requested_limit / default_limit)
フィルター割引(スキャンコストを削減):
| フィルター | 割引 | 適用されるエンドポイント |
|---|---|---|
| category | 0.7x | trending, top-performers, whales, capital-flow, high-conviction, opportunities |
| condition_id | 0.5x | whales, sentiment, participants, wallet activity |
| smart_money_only=true | 0.7x | whales, capital-flow, volume-heatmap(Polymarket + HL) |
| coin/coins | 0.7x | HL whales, long-short-ratio, pressure/pairs |
| pool_type("all" 以外) | 0.7x | pool_type パラメーターを持つすべての Meteora エンドポイント |
| pool_address | 0.5x | pool detail, volume-history, events, fee-analysis, positions/active |
特別ルール:
wallets/compare:price *= wallets.length / 2hl/traders/compare:price *= traders.length / 2meteora/lps/compare:price *= owners.length / 2wallets/profile:includes の両方を指定した場合は 1.0x、片方を指定した場合は 0.7x、どちらも指定しない場合は 0.4xwallets/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 個のエンドポイント)
| # | Method | Path | Tier | 説明 |
|---|---|---|---|---|
| 1 | GET | /api/v1/markets/trending | medium | 出来高が急増しているトレンド市場 |
| 2 | GET | /api/v1/markets/search | light | キーワード、カテゴリ、ステータス、または Polymarket URL で市場を検索 |
| 3 | GET | /api/v1/markets/categories | light | 活動状況の統計を含む全カテゴリ |
| 4 | GET | /api/v1/platform/stats | light | プラットフォーム全体の集計統計 |
| 5 | POST | /api/v1/markets/intelligence | heavy | 市場のスマートマネーに関する包括的なインテリジェンスレポート |
| 6 | GET | /api/v1/markets/price-history | light | OHLCV 価格/確率の時系列データ |
| 7 | POST | /api/v1/markets/sentiment | medium | スマートマネーのオーバーレイを含むセンチメントの時系列データ |
| 8 | POST | /api/v1/markets/participants | medium | スコアリング階層別の参加者概要 |
| 9 | POST | /api/v1/markets/insiders | heavy | インサイダーパターンの検出(7 つのシグナルによる行動スコアリング) |
| 10 | GET | /api/v1/markets/trades | light | 市場の時系列順の取引フィード |
| 11 | GET | /api/v1/markets/similar | whale | ウォレットの重複に基づく関連市場 |
| 12 | GET | /api/v1/markets/opportunities | whale | スマートマネーと価格の見方が食い違う市場 |
| 13 | GET | /api/v1/markets/high-conviction | heavy | 確信度の高いスマートマネーの賭け |
| 14 | GET | /api/v1/markets/capital-flow | medium | カテゴリ別の資本フロー(セクターローテーション) |
| 15 | GET | /api/v1/trades/whales | medium | 大口クジラの取引 |
| 16 | GET | /api/v1/markets/volume-heatmap | medium | カテゴリ/時間帯/曜日別の出来高分布 |
| 17 | POST | /api/v1/wallets/profile | heavy | スコア、ポジション、取引を含むウォレットの包括的な調査資料 |
| 18 | POST | /api/v1/wallets/activity | medium | ウォレットの最近の取引活動 |
| 19 | POST | /api/v1/wallets/pnl-breakdown | medium | 市場別の損益内訳 |
| 20 | POST | /api/v1/wallets/compare | whale | 2~5 個のウォレットを並べて比較 |
| 21 | POST | /api/v1/wallets/copy-traders | whale | 対象ウォレットをコピーするウォレットを検出 |
| 22 | GET | /api/v1/wallets/top-performers | heavy | 損益、ROI、シャープレシオ、勝率、出来高によるランキング |
| 23 | GET | /api/v1/wallets/niche-experts | heavy | 特定カテゴリのトップウォレット |
| 24 | GET | /api/v1/markets/resolutions | light | スマートマネーの予測精度を含む解決済み市場 |
| 25 | GET | /api/v1/wallets/alpha-callers | heavy | 後にトレンドとなる市場で早期に取引するウォレット |
| 26 | GET | /api/v1/markets/dumb-money | medium | 低スコアのトレーダーのポジション(逆張り指標) |
| 27 | GET | /api/v1/wallets/insiders | heavy | 行動スコアに基づくグローバルなインサイダー候補 |
Hyperliquid(18 エンドポイント)
| # | Method | Path | Tier | Description |
|---|---|---|---|---|
| 28 | GET | /api/v1/hl/platform/stats | light | プラットフォーム全体の統計 |
| 29 | GET | /api/v1/hl/coins/trending | medium | アクティビティ別のトレンドコイン |
| 30 | GET | /api/v1/hl/coins/list | light | 7日間の統計情報付き全取引コイン |
| 31 | GET | /api/v1/hl/coins/volume-heatmap | medium | コイン別・時間別の取引量 |
| 32 | GET | /api/v1/hl/traders/leaderboard | heavy | ランク付けされたトレーダーランキング |
| 33 | POST | /api/v1/hl/traders/profile | heavy | トレーダーの詳細情報 |
| 34 | POST | /api/v1/hl/traders/compare | whale | 2~5 人のトレーダーを比較 |
| 35 | GET | /api/v1/hl/traders/daily-pnl | medium | 連勝・連敗情報付きの日次損益時系列 |
| 36 | POST | /api/v1/hl/traders/pnl-by-coin | medium | コイン別の損益内訳(決済済み損益のみ) |
| 37 | GET | /api/v1/hl/traders/fresh-whales | heavy | 新たに現れた高取引量ウォレット |
| 38 | GET | /api/v1/hl/trades/whales | medium | 大口取引 |
| 39 | GET | /api/v1/hl/trades/feed | light | コイン別の時系列取引フィード |
| 40 | GET | /api/v1/hl/trades/long-short-ratio | medium | ロング/ショートの取引量比率の時系列 |
| 41 | GET | /api/v1/hl/smart-wallets/list | light | スコア付きスマートウォレット一覧 |
| 42 | GET | /api/v1/hl/smart-wallets/activity | medium | スマートウォレットの最近の取引 |
| 43 | GET | /api/v1/hl/smart-wallets/signals | heavy | コイン別に集約された方向性シグナル |
| 44 | GET | /api/v1/hl/pressure/pairs | heavy | スマートポジションを含むロング/ショート圧力 |
| 45 | GET | /api/v1/hl/pressure/summary | medium | 全コインの圧力サマリー |
Meteora(18 エンドポイント)
| # | Method | Path | Tier | Description |
|---|---|---|---|---|
| 46 | GET | /api/v1/meteora/pools/trending | medium | 取引量の急増別トレンドプール |
| 47 | GET | /api/v1/meteora/pools/top | medium | 取引量、手数料、または LP 数別の上位プール |
| 48 | GET | /api/v1/meteora/pools/search | light | アドレスまたはトークン名でプールを検索 |
| 49 | GET | /api/v1/meteora/pools/detail | medium | プールの詳細情報 |
| 50 | GET | /api/v1/meteora/pools/volume-history | light | 取引量の時系列 |
| 51 | GET | /api/v1/meteora/pools/events | light | 時系列イベントフィード |
| 52 | GET | /api/v1/meteora/pools/fee-analysis | medium | 手数料請求の分析 |
| 53 | GET | /api/v1/meteora/lps/top | heavy | 上位 LP のランキング |
| 54 | POST | /api/v1/meteora/lps/profile | heavy | LP の詳細情報 |
| 55 | GET | /api/v1/meteora/lps/whales | medium | 大口 LP イベント |
| 56 | POST | /api/v1/meteora/lps/compare | whale | 2~5 人の LP を比較 |
| 57 | GET | /api/v1/meteora/positions/active | medium | アクティブな LP ポジション |
| 58 | GET | /api/v1/meteora/positions/history | light | ポジションイベント履歴(DLMM のみ) |
| 59 | GET | /api/v1/meteora/platform/stats | light | プラットフォーム全体の統計 |
| 60 | GET | /api/v1/meteora/platform/volume-heatmap | medium | アクション別・時間別の取引量 |
| 61 | GET | /api/v1/meteora/platform/metengine-share | light | MetEngine のルーティングシェア |
| 62 | GET | /api/v1/meteora/dca/pressure | medium | トークン別の DCA 蓄積圧力 |
| 63 | GET | /api/v1/meteora/pools/smart-wallet | heavy | スマートウォレットの LP アクティビティが最も高いプール |
エンドポイント完全リファレンス
レスポンスエンベロープ
すべての 200 レスポンスは次の形式です:{ "data": <payload> }
すべてのエラーレスポンスは次の形式です:{ "error": "<message>" }。任意の "reason" フィールドを含む場合があります。
POLYMARKET
1. GET /api/v1/markets/trending
取引量が急増しているトレンド市場です。
パラメーター(クエリ文字列):
| Param | Type | Default | Values | Required |
|---|---|---|---|---|
| timeframe | string | 24h | 1h, 4h, 12h, 24h, 7d | no |
| category | string | - | any valid category | no |
| sort_by | string | volume_spike | volume_spike, trade_count, smart_money_inflow | no |
| limit | integer | 20 | 1-100 | no |
レスポンススキーマ:
{
"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 を指定できます。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| query | string | - | キーワードまたは Polymarket の URL | いいえ |
| category | string | - | 有効なカテゴリ | いいえ |
| status | string | active | active, closing_soon, resolved | いいえ |
| has_smart_money_signal | boolean | - | true, false | いいえ |
| sort_by | string | relevance | end_date, volume, relevance | いいえ |
| limit | integer | 20 | 1-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_stats | boolean | true | true, false | いいえ |
| timeframe | string | 24h | 24h, 7d | いいえ |
レスポンススキーマ:
{
"data": [
{
"name": "string",
"active_markets": "number",
"period_volume": "number",
"period_trades": "number",
"unique_traders": "number"
}
]
}
4. GET /api/v1/platform/stats
プラットフォーム全体の集計統計です。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| timeframe | string | 24h | 24h, 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_id | string | - | - | はい |
| top_n_wallets | integer | 10 | 1-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_id | string | - | - | はい |
| timeframe | string | 7d | 1h, 4h, 12h, 24h, 7d, 30d | いいえ |
| bucket_size | string | 1h | 5m, 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_id | string | - | - | はい |
| timeframe | string | 7d | 24h, 7d, 30d | いいえ |
| bucket_size | string | 4h | 1h, 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_id | string | - | - | はい |
レスポンススキーマ:
{
"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_id | string | - | - | はい |
| limit | integer | 25 | 1-100 | いいえ |
| min_score | integer | 20 | 0-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_id | string | - | - | はい |
| timeframe | string | 24h | 1h, 4h, 12h, 24h, 7d, 30d | いいえ |
| side | string | - | BUY, SELL | いいえ |
| min_usdc | number | 0 | >= 0 | いいえ |
| smart_money_only | boolean | false | true, false | いいえ |
| limit | integer | 100 | 1-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_id | string | - | - | はい |
| limit | integer | 10 | 1-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 | 文字列 | moderate | weak, moderate, strong | いいえ |
| category | 文字列 | - | 有効なカテゴリー | いいえ |
| closing_within_hours | 整数 | - | 最大 720 | いいえ |
| min_smart_wallets | 整数 | 3 | >= 1 | いいえ |
| limit | 整数 | 20 | 1-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 | 整数 | 65 | 0-100 | いいえ |
| limit | 整数 | 20 | 1-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 | 文字列 | 7d | 24h, 7d, 30d | いいえ |
| smart_money_only | ブール値 | false | true, false | いいえ |
| top_n_categories | 整数 | 20 | 1-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 | 文字列 | 24h | 1h, 4h, 12h, 24h, 7d, 30d | いいえ |
| condition_id | 文字列 | - | - | いいえ |
| category | 文字列 | - | 有効なカテゴリー | いいえ |
| side | 文字列 | - | BUY, SELL | いいえ |
| smart_money_only | ブール値 | false | true, false | いいえ |
| limit | 整数 | 50 | 1-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 | 文字列 | 24h | 24h, 7d, 30d | いいえ |
| group_by | 文字列 | category | category, hour_of_day, day_of_week | いいえ |
| smart_money_only | ブール値 | false | true, 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 | ブール値 | true | true, false | いいえ |
| include_trades | ブール値 | true | true, false | いいえ |
| trades_limit | 整数 | 50 | 1-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 | 文字列 | 24h | 1h, 4h, 24h, 7d, 30d | いいえ |
| category | 文字列 | - | 有効なカテゴリー | いいえ |
| min_usdc | 数値 | 0 | >= 0 | いいえ |
| limit | 整数 | 100 | 1-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 | 文字列 | 90d | 7d, 30d, 90d, all | いいえ |
| limit | 整数 | 50 | 1-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):
| フィールド | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| wallets | string[] | - | 小文字のアドレス 2~5 個 | はい |
| include_shared_positions | boolean | true | true, 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):
| フィールド | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| wallet | string | - | 小文字のアドレス | はい |
| max_lag_minutes | integer | 60 | 1-1440 | いいえ |
| timeframe | string | 7d | 24h, 7d, 30d | いいえ |
| min_overlap_trades | integer | 3 | >= 1 | いいえ |
| limit | integer | 20 | 1-100 | いいえ |
レスポンススキーマ:
{
"data": [
{
"wallet": "string",
"overlap_trades": "number",
"avg_lag_seconds": "number",
"copied_tokens": "array",
"wallet_score": "number"
}
]
}
22. GET /api/v1/wallets/top-performers
リーダーボードです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| timeframe | string | 7d | today, 24h, 7d, 30d, 90d, 365d | いいえ |
| category | string | - | 有効なカテゴリー | いいえ |
| metric | string | pnl | pnl, roi, sharpe, win_rate, volume | いいえ |
| min_trades | integer | 5 | >= 1 | いいえ |
| limit | integer | 25 | 1-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
特定のカテゴリーで上位のウォレットです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| category | string | - | 有効なカテゴリー | はい |
| min_category_trades | integer | 10 | >= 1 | いいえ |
| sort_by | string | category_sharpe | category_sharpe, category_pnl, category_volume | いいえ |
| limit | integer | 25 | 1-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
スマートマネーの正確性を含む、決着済みのマーケットです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| category | string | - | 有効なカテゴリー | いいえ |
| query | string | - | キーワード | いいえ |
| sort_by | string | resolved_recently | resolved_recently, volume, smart_money_accuracy | いいえ |
| limit | integer | 25 | 1-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_back | integer | 30 | 1-90 | いいえ |
| min_days_early | integer | 7 | 1-60 | いいえ |
| min_bet_usdc | number | 100 | >= 0 | いいえ |
| limit | integer | 25 | 1-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_id | string | - | - | はい |
| max_score | integer | 30 | 0-100 | いいえ |
| min_trades | integer | 5 | >= 1 | いいえ |
| limit | integer | 50 | 1-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
行動スコアに基づく、全体のインサイダー候補です。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| limit | integer | 50 | 1-200 | いいえ |
| min_score | integer | 50 | 0-100 | いいえ |
| max_wallet_age_days | integer | 60 | 1-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
アクティビティ別のトレンドコインです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| timeframe | string | 24h | 1h, 4h, 12h, 24h, 7d | いいえ |
| limit | integer | 20 | 1-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 統計付きの、取引対象となるすべてのコインです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| limit | integer | 100 | 1-500 | いいえ |
レスポンススキーマ:
{
"data": [
{
"coin": "string",
"volume_usd": "number",
"trade_count": "number",
"unique_traders": "number"
}
]
}
31. GET /api/v1/hl/coins/volume-heatmap
コイン別、時間別の取引量です。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| timeframe | string | 24h | 24h, 7d | いいえ |
| limit | integer | 20 | 1-50 | いいえ |
レスポンススキーマ:
{
"data": [
{
"coin": "string",
"bucket": "string",
"volume_usd": "number",
"trade_count": "number",
"smart_volume_usd": "number"
}
]
}
32. GET /api/v1/hl/traders/leaderboard
ランキング形式のトレーダーリーダーボードです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| timeframe | string | all | 1d, 7d, 30d, all | いいえ |
| sort_by | string | pnl | pnl, roi, win_rate, volume | いいえ |
| sort_order | string | desc | desc, asc | いいえ |
| min_trades | integer | 10 | >= 1 | いいえ |
| limit | integer | 25 | 1-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):
| フィールド | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| trader | string | - | 0x address | はい |
| days | integer | 30 | 1-365 | いいえ |
| trades_limit | integer | 50 | 1-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):
| フィールド | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| traders | string[] | - | 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 時系列データです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| trader | string | - | 0x address | はい |
| days | integer | 30 | 1-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):
| フィールド | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| trader | string | - | 0x address | はい |
| days | integer | 90 | 1-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_days | integer | 14 | 1-90 | いいえ |
| min_volume | number | 100000 | >= 0 | いいえ |
| min_pnl | number | 0 | any | いいえ |
| limit | integer | 25 | 1-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_usd | number | 50000 | >= 1 | いいえ |
| timeframe | string | 24h | 1h, 4h, 12h, 24h, 7d | いいえ |
| coin | string | - | 大文字のシンボル(例:BTC) | いいえ |
| side | string | - | Open Long, Open Short, Close Long, Close Short | いいえ |
| direction | string | - | Long, Short | いいえ |
| smart_money_only | boolean | false | true, false | いいえ |
| limit | integer | 50 | 1-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
コインの時系列順取引フィードです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| coin | string | - | 大文字のシンボル | はい |
| limit | integer | 100 | 1-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
ロング/ショート出来高比率の時系列データです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| coin | string | - | 大文字のシンボル | はい |
| timeframe | string | 7d | 24h, 7d, 30d | いいえ |
| bucket_size | string | 4h | 1h, 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_by | string | score | score, pnl, volume | いいえ |
| limit | integer | 50 | 1-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
スマートウォレットの最近の取引です。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| timeframe | string | 24h | 1h, 4h, 12h, 24h, 7d | いいえ |
| min_score | integer | 60 | 0-100 | いいえ |
| limit | integer | 100 | 1-500 | いいえ |
レスポンススキーマ:
{
"data": {
"period_summary": "object",
"trades": "array"
}
}
43. GET /api/v1/hl/smart-wallets/signals
コインごとに集約された方向性シグナルです。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| timeframe | string | 24h | 6h, 12h, 24h, 7d | いいえ |
| min_score | integer | 60 | 0-100 | いいえ |
| limit | integer | 20 | 1-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
スマートポジションを含むロング/ショートの圧力です。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| coins | string | - | カンマ区切り(デフォルトは上位 10 件) | いいえ |
| trades_limit | integer | 20 | 1-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_type | string | all | dlmm, damm_v2, all | いいえ |
| timeframe | string | 24h | 24h, 7d | いいえ |
| limit | integer | 20 | 1-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_type | string | all | dlmm, damm_v2, all | いいえ |
| sort_by | string | volume | volume, lp_count, events, fees | いいえ |
| timeframe | string | 7d | 24h, 7d, 30d | いいえ |
| limit | integer | 20 | 1-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
アドレスまたはトークン名でプールを検索します。
パラメーター(クエリ文字列):
| Param | Type | Default | Values | Required |
|---|---|---|---|---|
| query | string | - | プールアドレスまたはトークン名 | はい |
| pool_type | string | all | dlmm, damm_v2, all | いいえ |
| limit | integer | 10 | 1-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
プールの詳細情報です。
パラメーター(クエリ文字列):
| Param | Type | Default | Values | Required |
|---|---|---|---|---|
| pool_address | string | - | Solana pubkey | はい |
| pool_type | string | - | 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
出来高の時系列データです。
パラメーター(クエリ文字列):
| Param | Type | Default | Values | Required |
|---|---|---|---|---|
| pool_address | string | - | Solana pubkey | はい |
| pool_type | string | - | dlmm, damm_v2(省略時は自動検出) | いいえ |
| timeframe | string | 7d | 24h, 7d, 30d | いいえ |
| bucket_size | string | 4h | 1h, 4h, 1d | いいえ |
レスポンススキーマ:
{
"data": [
{
"bucket": "string",
"volume_usd": "number",
"event_count": "number",
"action_breakdown": "object"
}
]
}
51. GET /api/v1/meteora/pools/events
時系列順のイベントフィードです。
パラメーター(クエリ文字列):
| Param | Type | Default | Values | Required |
|---|---|---|---|---|
| pool_address | string | - | Solana pubkey | はい |
| pool_type | string | - | dlmm, damm_v2(省略時は自動検出) | いいえ |
| limit | integer | 100 | 1-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
手数料請求の分析です。
パラメーター(クエリ文字列):
| Param | Type | Default | Values | Required |
|---|---|---|---|---|
| pool_address | string | - | Solana pubkey | はい |
| pool_type | string | - | dlmm, damm_v2(省略時は自動検出) | いいえ |
| timeframe | string | 7d | 24h, 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のランキングです。
パラメーター(クエリ文字列):
| Param | Type | Default | Values | Required |
|---|---|---|---|---|
| pool_type | string | all | dlmm, damm_v2, all | いいえ |
| sort_by | string | volume | volume, pool_count, events | いいえ |
| timeframe | string | 30d | 7d, 30d | いいえ |
| limit | integer | 25 | 1-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):
| Field | Type | Default | Values | Required |
|---|---|---|---|---|
| owner | string | - | Solana pubkey | はい |
| pool_type | string | all | dlmm, damm_v2, all | いいえ |
| events_limit | integer | 50 | 1-500 | いいえ |
レスポンススキーマ:
{
"data": {
"owner": "string",
"summary": "object",
"pool_breakdown": "array",
"recent_events": "array"
}
}
55. GET /api/v1/meteora/lps/whales
大口LPのイベントです。
パラメーター(クエリ文字列):
| Param | Type | Default | Values | Required |
|---|---|---|---|---|
| pool_type | string | all | dlmm, damm_v2, all | いいえ |
| min_usd | number | 10000 | >= 1 | いいえ |
| timeframe | string | 24h | 24h, 7d, 30d | いいえ |
| limit | integer | 50 | 1-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):
| Field | Type | Default | Values | Required |
|---|---|---|---|---|
| owners | string[] | - | 2-5件のSolana pubkey | はい |
| pool_type | string | all | dlmm, 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_address | string | - | Solana pubkey | いいえ |
| owner | string | - | Solana pubkey | いいえ |
| pool_type | string | all | dlmm, damm_v2, all | いいえ |
| limit | integer | 50 | 1-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_address | string | - | - | はい |
レスポンススキーマ:
{
"data": {
"position_address": "string",
"events": [
{
"event_type": "string",
"usd_total": "number",
"timestamp": "string",
"tx_id": "string"
}
]
}
}
59. GET /api/v1/meteora/platform/stats
プラットフォーム全体の統計情報。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| pool_type | string | all | dlmm, 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_type | string | all | dlmm, damm_v2, all | いいえ |
| timeframe | string | 24h | 24h, 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_type | string | all | dlmm, damm_v2, all | いいえ |
| timeframe | string | 7d | 24h, 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 蓄積圧力。
パラメーター(クエリ文字列):
| パラメーター | 型 | デフォルト | 値 | 必須 |
|---|---|---|---|---|
| token | string | - | 特定の mint アドレス | いいえ |
| timeframe | string | 1h | 1m, 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_type | string | all | dlmm, damm_v2, all | いいえ |
| limit | integer | 20 | 1-100 | いいえ |
| timeframe | string | 7d | 24h, 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 でできないこと:
- 取引の実行はできません。 読み取り専用の分析機能です。いずれのプラットフォームでも注文を出すことはできません。
- リアルタイムのストリーミングには対応していません。 リクエストとレスポンスのみです。WebSocket フィードはありません。
- 過去データをオンデマンドで遡って取得することはできません。 データは、MetEngine が各プラットフォームのインデックス作成を開始した時点から利用できます。
- Hyperliquid の未実現損益には対応していません。 利用できるのは、決済済み(実現)損益のみです。
- Meteora ポジションの時価評価には対応していません。 純価値は入金額から出金額を差し引いたものであり、現在の市場価値ではありません。
- Polymarket のオーダーブックデータはありません。 取引のみで、未約定注文や流動性の深さは含まれません。
- カスタムのスコアリングモデルには対応していません。 ウォレットスコアには MetEngine 独自のモデルが使用されます。エージェントごとのカスタマイズはできません。
- プラットフォーム間のウォレット紐付けには対応していません。 同じ主体が管理している場合でも、Polymarket の Polygon アドレスと Meteora の Solana アドレスは紐付けられません。
- トークン価格フィードはありません。 価格オラクルではありません。Polymarket の市場価格は、暗示確率(0-1)です。
- エンドポイントは 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 にはありません。
アドレスの規則
| プラットフォーム | 形式 | 大文字と小文字の区別 |
|---|---|---|
| Polymarket | 0x hex(Polygon) | 小文字である必要があります |
| Hyperliquid | 0x hex | 大文字と小文字を区別しません |
| Meteora | Base58(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件必要です。