Ever Platform
RoadmapIdeasDeveloper ToolsSDK
  • About Ever Platform
  • Sandbox endpoint
  • Quick Start
  • Use cases
    • Infrastructure Provider
      • Projects
    • Community-driven development
      • Roadmap
        • Discussions
      • Your ideas
      • DevNet Giver(Faucet)
    • Custom development
      • Our clients
  • Products
    • Evercloud
      • Networks Endpoints
      • Get Started
      • GraphQL API documentation
      • Testnet Faucets
      • About data proofs in Cloud
      • SLA
      • HTTP notifications
    • Dedicated Cloud/Node
    • Dapp Server (DS)
    • Simple Emulator (SE)
      • Endpoint
    • Network Emulator (NE)
    • Functionality comparison
  • Samples
    • GraphQL Samples
      • Send message
      • Network Config
      • Blocks
      • Accounts
      • Transactions
      • Messages
      • Block and Transaction Pagination: Best Practice
      • Multiple Message Processing and Monitoring
      • Subscribe for REMP receipts
  • Reference
    • GraphQL API
      • Quick Start
      • Samples
      • Networks
      • Explore Playground
      • Connect to GraphQL API
      • Schema
      • Blockchain API
      • Info API
      • Query Collections: Query Language
      • Subscribe Collections
      • Message Monitor API
      • Field Descriptions
    • Evercloud API Add-ons
      • Query cost
      • Blockchain Statistics
      • FT (Fungible Token) API
      • Price
      • Counterparties
      • Flex API
    • Changelog
      • Evercloud
      • Dapp Server (DS)
      • Simple Emulator (SE)
    • Breaking changes
      • Policy
      • Deprecation schedule
      • Migration guides
        • GraphQL API 1.0 migration
  • SDK and tools
    • everdev
    • Client Libraries
  • Guides
    • How to connect to GraphQL API
  • 😊Social
    • Feedback page
    • Telegram
    • Discord
Powered by GitBook
On this page
  • Root types
  • Non-root types
  • Query types
  • Subscription types
  • Mutation types
  • Syntax

Was this helpful?

  1. Reference
  2. GraphQL API

Schema

PreviousConnect to GraphQL APINextBlockchain API

Last updated 2 years ago

Was this helpful?

A schema defines a type system of GraphQL API. It describes the complete set of possible data (objects, fields, relationships, everything) that a client can access.

Root types

TON Labs GraphQL schema has three root types:

  • query

  • mutation

  • subscription

The subscription root type – a long‐lived request that fetches data in response to source events.

Non-root types

Query types

Root resolvers

name
description

Info query is used to get GraphQL API version, as well as health parameters of the API, such as latency of blocks, messages and transactions

API that includes a set of functions for pagination of blocks, key blocks, transactions and account’s transactions and messages.

Fungible Token API provides data about fungible tokens, transfers, holders.

Blocks analytics

Accounts analytics

Messages analytics

Transactions analytics

blocks_signatures

Block signatures analytics

General Everscale Network statistics related to accounts, transactions, messages and blocks. And also some essential statistics about validators and depools such as total number of validators, total staked amount etc. Available only in Evercloud API.

Returns a list of addresses the specified account interacted with, sorted by the latest interaction time (the latest message time between 2 accounts) DESC. Feature may be useful for wallet applications or for chat-based DApps to show the list of counterparties in descending order. Available only in Evercloud API.

Aggregation queries:

name
description

aggregateBlocks

Get aggregation info about blocks: COUNT, SUM, MAX, MIN, AVERAGE functions over blocks data.

aggregateTransactions

Get aggregation info about transactions: COUNT, SUM, MAX, MIN, AVERAGE functions over transactions data.

aggregateMessages

Get aggregation info about messages: COUNT, SUM, MAX, MIN, AVERAGE functions over messages data.

aggregateAccounts

Get aggregation info about accounts: COUNT, SUM, MAX, MIN, AVERAGE functions over accounts data.

aggregateBlockSignatures

Get aggregation info about block signaturess: COUNT, SUM, MAX, MIN, AVERAGE functions over block signatures data.

Subscription types

  • blocks

  • accounts

  • messages

  • transaction

  • blocks_signatures

  • counterparties

  • rempReceipts - subscription for REMP processing status receipts of a message (by messageId)

Mutation types

  • postRequests - used to send messages to blockchain.

Syntax

query {
  blockchain{
   account(address:"0:653b9a6452c7a982c6dc92b2da9eba832ade1c467699ebb3b43dca6d77b780dd"){
    info{
      address
      acc_type
      balance
      last_paid
      last_trans_lt
      boc
      data
      code
      library
      data_hash
      code_hash
      library_hash
    }
    transactions(last:1){
      edges{
        node{
          hash
          now
          balance_delta
        }
      }
    }
  }
  }
}

Here you can see a request for account's information and the last transaction with a subset of fields. All available fields with their descriptions can be found in data schema in playground.

A selection set must contain only scalar fields, otherwise you will get an error. A scalar field describes one discrete piece of information available to a request within a selection set. If field is an object, you need to specify the fields of this object.

Read more in the next sections.

The defines GraphQL operations that retrieve data from the server.

The defines GraphQL operations that change data on the server. It is analogous to performing HTTP verbs such as POST, PATCH, and DELETE. Mutations are used to send messages to the blockchain. We recommend to do it only via SDK, not directly.

Check out - the official EverX wrapper over GraphQL API for root queries and subscriptions.

See non-root type descriptions in section.

Read about GraphQL syntax in its . In this example we query account info:

query type
mutation type
EVER-SDK net module
Field descriptions
official documentation
ft
info
blockchain
statistics
counterparties
Root types
Non-root types
Query types
Subscription types
Mutation types
Syntax
blocks
accounts
messages
transaction