GraphQLエンドポイント
GraphQLでSmart Moneyデータをクエリ。固定されたRESTレスポンスではなく、必要なフィールドを柔軟に取得できます。
概要
GraphQLエンドポイントはREST APIの代替を提供します。必要なデータだけをクエリし、使わないフィールドの過剰取得や複数リクエストが必要な不足取得を回避。ProおよびEnterpriseプランで利用可能。
エンドポイント
URL: https://api.smartmoneyapi.com/graphql
メソッド: POST
Content-Type: application/json
認証
AuthorizationヘッダーにAPIキーを含めてください:
HTTP
POST /graphql HTTP/1.1
Host: api.smartmoneyapi.com
Authorization: Bearer sk_live_abc123xyz789
Content-Type: application/json
クエリ例
クエリ: ホエールポジション
GraphQL
query {
whalePositions(filter: {
symbol: "BTCUSDT"
exchange: "bybit"
direction: "long"
}, limit: 20) {
id
walletAddress
symbol
positionSize
entryPrice
currentPrice
pnl
pnlPercent
leverage
liquidationPrice
fundingRate
lastUpdated
}
}
クエリ: 取引所間の資金調達レート
GraphQL
query {
fundingRates(symbol: "BTCUSDT") {
timestamp
symbol
exchanges {
name
rate
nextRate
}
aggregated {
mean
median
spread
}
}
}
クエリ: 複数シンボル
GraphQL
query GetMultipleSymbols($symbols: [String!]!) {
whalePositions(symbols: $symbols, limit: 10) {
symbol
totalPositions
totalLongSize
totalShortSize
averageEntryPrice
}
fundingRates(symbols: $symbols) {
symbol
bybit { rate }
binance { rate }
hyperliquid { rate }
}
}
クエリ変数例
JSON
{
"symbols": ["BTCUSDT", "ETHUSDT", "SOLUSDT"]
}
ミューテーション
ウェブフック作成
GraphQL
mutation {
createWebhook(input: {
url: "https://yourapp.com/webhook"
events: ["whale.position.opened", "liquidation.large"]
active: true
}) {
id
url
events
active
createdAt
}
}
GraphQLエクスプローラー
インタラクティブエクスプローラー
GraphQLエクスプローラーを使用してスキーマを閲覧し、クエリを作成し、オートコンプリートとドキュメントを備えたリアルタイムテストが可能です。
GraphQLエクスプローラーを開く主な利点
必要なものだけを取得: 過剰取得なし。使用するフィールドのみをリクエスト。
複雑なデータの単一リクエスト: ホエールポジションと資金調達レートを別々の呼び出しなしで同時取得。
強力な型付け: スキーマが全ての型と利用可能なフィールドを完全なドキュメントと共に定義。
パフォーマンス向上: より小さなレスポンスペイロード、クライアント側の高速な解析。
完全なイントロスペクション: GraphQLツールで直接利用可能なクエリと型を閲覧。