GraphQL Endpoint

Truy vấn dữ liệu Smart Money với GraphQL. Nhận chính xác các trường bạn cần với truy vấn linh hoạt thay vì phản hồi REST cố định.

Tổng quan

GraphQL endpoint cung cấp một giải pháp thay thế cho REST API. Truy vấn chính xác những gì bạn cần—tránh lấy dư thừa các trường không sử dụng hoặc thiếu dữ liệu đòi hỏi nhiều yêu cầu. Có sẵn trên gói Pro và Enterprise.

Endpoint

URL: https://api.smartmoneyapi.com/graphql

Phương thức: POST

Content-Type: application/json

Xác thực

Bao gồm API key của bạn trong header Authorization:

HTTP

POST /graphql HTTP/1.1
Host: api.smartmoneyapi.com
Authorization: Bearer sk_live_abc123xyz789
Content-Type: application/json

Ví dụ Truy vấn

Truy vấn: Vị thế Cá voi

GraphQL

query {
  whalePositions(filter: {
    symbol: "BTCUSDT"
    exchange: "bybit"
    direction: "long"
  }, limit: 20) {
    id
    walletAddress
    symbol
    positionSize
    entryPrice
    currentPrice
    pnl
    pnlPercent
    leverage
    liquidationPrice
    fundingRate
    lastUpdated
  }
}

Truy vấn: Funding Rates Trên Các Sàn

GraphQL

query {
  fundingRates(symbol: "BTCUSDT") {
    timestamp
    symbol
    exchanges {
      name
      rate
      nextRate
    }
    aggregated {
      mean
      median
      spread
    }
  }
}

Truy vấn: Nhiều Cặp Symbol

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

Ví dụ Biến Truy vấn

JSON

{
  "symbols": ["BTCUSDT", "ETHUSDT", "SOLUSDT"]
}

Mutations

Tạo Webhook

GraphQL

mutation {
  createWebhook(input: {
    url: "https://yourapp.com/webhook"
    events: ["whale.position.opened", "liquidation.large"]
    active: true
  }) {
    id
    url
    events
    active
    createdAt
  }
}

GraphQL Explorer

Trình Khám phá Tương tác

Sử dụng GraphQL Explorer để duyệt schema, viết truy vấn và kiểm tra thời gian thực với đầy đủ tự động hoàn thành và tài liệu.

Mở GraphQL Explorer

Lợi ích Chính

Nhận chính xác những gì bạn cần: Không lấy dư thừa. Chỉ yêu cầu các trường bạn sử dụng.

Một yêu cầu cho dữ liệu phức tạp: Lấy vị thế cá voi và funding rates cùng lúc mà không cần gọi riêng lẻ.

Kiểu dữ liệu mạnh: Schema định nghĩa tất cả kiểu và trường khả dụng với tài liệu đầy đủ.

Hiệu suất tốt hơn: Phản hồi nhẹ hơn, phân tích nhanh hơn ở phía client.

Introspection đầy đủ: Duyệt các truy vấn và kiểu khả dụng trực tiếp trong công cụ GraphQL.

Khám phá GraphQL

Thử các truy vấn linh hoạt với GraphQL Explorer. Có sẵn trên gói Pro và Enterprise.

Mở Explorer