GraphQL Endpoint

Query Smart Money data with GraphQL. Get exactly the fields you need with flexible queries instead of fixed REST responses.

Overview

The GraphQL endpoint provides an alternative to REST API. Query exactly what you need—avoid over-fetching unused fields and under-fetching requiring multiple requests. Available on Pro and Enterprise plans.

Endpoint

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

Method: POST

Content-Type: application/json

Authentication

Include your API key in the Authorization header:

HTTP

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

Query Examples

Query: Whale Positions

GraphQL

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

Query: Funding Rates Across Exchanges

GraphQL

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

Query: Multiple Symbols

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

Query Variables Example

JSON

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

Mutations

Create 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

Interactive Explorer

Use GraphQL Explorer to browse schema, write queries, and test in real-time with full autocomplete and documentation.

Open GraphQL Explorer

Key Advantages

Get exactly what you need: No over-fetching. Request only the fields you use.

Single request for complex data: Fetch whale positions and funding rates together without separate calls.

Strong typing: Schema defines all types and available fields with full documentation.

Better performance: Smaller response payloads, faster parsing on client.

Full introspection: Browse available queries and types directly in GraphQL tools.

Explore GraphQL

Try flexible queries with GraphQL Explorer. Available on Pro and Enterprise plans.

Open Explorer