GraphQL Endpoint

Interroga i dati Smart Money con GraphQL. Ottieni esattamente i campi necessari con query flessibili invece di risposte REST fisse.

Panoramica

L'endpoint GraphQL offre un'alternativa alle API REST. Interroga esattamente ciò che ti serve—evita di recuperare campi inutilizzati o di dover fare più richieste. Disponibile sui piani Pro ed Enterprise.

Endpoint

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

Metodo: POST

Content-Type: application/json

Autenticazione

Includi la tua API key nell'header Authorization:

HTTP

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

Esempi di query

Query: Posizioni delle balene

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: Tassi di funding tra exchange

GraphQL

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

Query: Multipli simboli

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

Esempio di variabili di query

JSON

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

Mutation

Crea 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

Explorer interattivo

Usa GraphQL Explorer per esplorare lo schema, scrivere query e testare in tempo reale con autocompletamento e documentazione completa.

Apri GraphQL Explorer

Vantaggi chiave

Ottieni esattamente ciò che ti serve: Nessun over-fetching. Richiedi solo i campi che utilizzi.

Singola richiesta per dati complessi: Recupera posizioni delle balene e tassi di funding insieme senza chiamate separate.

Tipizzazione forte: Lo schema definisce tutti i tipi e i campi disponibili con documentazione completa.

Migliori prestazioni: Payload di risposta più piccoli, parsing più veloce lato client.

Introspizione completa: Esplora query e tipi disponibili direttamente negli strumenti GraphQL.

Esplora GraphQL

Prova query flessibili con GraphQL Explorer. Disponibile sui piani Pro ed Enterprise.

Apri Explorer