GraphQL 端点

使用 GraphQL 查询 Smart Money 数据。通过灵活的查询获取您所需的字段，而非固定的 REST 响应。

概览

GraphQL 端点提供了 REST API 的替代方案。精确查询您所需的内容——避免获取未使用的字段和需要多次请求的不足。适用于 Pro 和 Enterprise 计划。

端点

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

方法： POST

内容类型： 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"]
}

变更

创建 Webhook

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 工具中浏览可用查询和类型。

探索 GraphQL

使用 GraphQL 探索器尝试灵活查询。适用于 Pro 和 Enterprise 计划。

打开探索器