openapi.yml

openapi: 3.0.0
info:
  title: REST api to TON blockchain explorer
  version: 2.0.0
  description: Provide access to indexed TON blockchain
  contact:
    name: Support
    email: support@tonkeeper.com
servers:
  - url: "https://tonapi.io"
  - url: "https://testnet.tonapi.io"
  - url: "http://localhost:8081"

tags:
  - name: Accounts
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/accounts
  - name: Migration
  - name: NFT
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/nft
  - name: Jettons
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/jettons
  - name: DNS
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/dns
  - name: Wallet
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/wallet
  - name: Rates
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/rates
  - name: Staking
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/staking
  - name: Traces
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/traces
  - name: Events
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/events
  - name: Storage
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/storage
  - name: Connect
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/connect
  - name: Gasless
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/gasless
  - name: Multisig
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/multisig
  - name: Blockchain
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/blockchain
  - name: Lite Server
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/lite-server
  - name: Emulation
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/emulation
  - name: Utilities
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/utilities
  - name: ExtraCurrency
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/extra-currency
  - name: Purchases

paths:
  /v2/openapi.json:
    get:
      description: Get the openapi.json file
      operationId: getOpenapiJson
      tags:
        - Utilities
      responses:
        '200':
          description: openapi.json
          content:
            application/json:
              schema: { } # Free-form JSON value
        'default':
          $ref: '#/components/responses/Error'
  /v2/openapi.yml:
    get:
      description: Get the openapi.yml file
      operationId: getOpenapiYml
      tags:
        - Utilities
      responses:
        '200':
          description: openapi.yml
          content:
            application/yaml:
              schema:
                type: string
                format: binary
        'default':
          $ref: '#/components/responses/Error'
  /v2/status:
    get:
      description: Status
      operationId: status
      tags:
        - Utilities
      responses:
        '200':
          description: status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceStatus'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/reduced/blocks:
    get:
      description: Get reduced blockchain blocks data
      operationId: getReducedBlockchainBlocks
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/fromQuery'
        - $ref: '#/components/parameters/toQuery'
      responses:
        '200':
          description: blockchain reduced blocks
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReducedBlocks'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/blocks/{block_id}:
    get:
      description: Get blockchain block data
      operationId: getBlockchainBlock
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDParameter'
      responses:
        '200':
          description: blockchain block
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainBlock'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/blocks/{block_id}/boc:
    get:
      description: Download blockchain block BOC
      operationId: downloadBlockchainBlockBoc
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDParameter'
      responses:
        '200':
          description: Block BOC file
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
          headers:
            Content-Disposition:
              schema:
                type: string
                example: 'attachment; filename="block.boc"'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/masterchain/{masterchain_seqno}/shards:
    get:
      description: Get blockchain block shards
      operationId: getBlockchainMasterchainShards
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/masterchainSeqno'
      responses:
        '200':
          description: blockchain block shards
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainBlockShards'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/masterchain/{masterchain_seqno}/blocks:
    get:
      description: Get all blocks in all shards and workchains between target and previous masterchain block according to shards last blocks snapshot in masterchain.  We don't recommend to build your app around this method because it has problem with scalability and will work very slow in the future.
      operationId: getBlockchainMasterchainBlocks
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/masterchainSeqno'
      responses:
        '200':
          description: blockchain blocks
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainBlocks'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/masterchain/{masterchain_seqno}/transactions:
    get:
      description: Get all transactions in all shards and workchains between target and previous masterchain block according to shards last blocks snapshot in masterchain. We don't recommend to build your app around this method because it has problem with scalability and will work very slow in the future.
      operationId: getBlockchainMasterchainTransactions
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/masterchainSeqno'
        - $ref: '#/components/parameters/offsetQuery'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 100
            minimum: 1
      responses:
        '200':
          description: blockchain transactions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transactions'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/masterchain/{masterchain_seqno}/config:
    get:
      description: Get blockchain config from a specific block, if present.
      operationId: getBlockchainConfigFromBlock
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/masterchainSeqno'
      responses:
        '200':
          description: blockchain config
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainConfig'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/masterchain/{masterchain_seqno}/config/raw:
    get:
      description: Get raw blockchain config from a specific block, if present.
      operationId: getRawBlockchainConfigFromBlock
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/masterchainSeqno'
      responses:
        '200':
          description: blockchain config
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RawBlockchainConfig'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/blocks/{block_id}/transactions:
    get:
      description: Get transactions from block
      operationId: getBlockchainBlockTransactions
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDParameter'
      responses:
        '200':
          description: blockchain block transactions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transactions'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/transactions/{transaction_id}:
    get:
      description: Get transaction data
      operationId: getBlockchainTransaction
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/transactionIDParameter'
      responses:
        '200':
          description: blockchain transaction
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/messages/{msg_id}/transaction:
    get:
      description: Get transaction data by message hash
      operationId: getBlockchainTransactionByMessageHash
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/messageIDParameter'
      responses:
        '200':
          description: transaction by message hash
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/validators:
    get:
      description: Get blockchain validators
      operationId: getBlockchainValidators
      tags:
        - Blockchain
      responses:
        '200':
          description: blockchain validators
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Validators'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/masterchain-head:
    get:
      description: Get last known masterchain block
      operationId: getBlockchainMasterchainHead
      tags:
        - Blockchain
      responses:
        '200':
          description: blockchain masterchain head
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainBlock'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/accounts/{account_id}:
    get:
      description: Get low-level information about an account taken directly from the blockchain.
      operationId: getBlockchainRawAccount
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: raw account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainRawAccount'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/accounts/_bulk:
    post:
      description: Get low-level information about several accounts taken directly from the blockchain.
      operationId: getBlockchainRawAccounts
      tags:
        - Blockchain
      requestBody:
        $ref: "#/components/requestBodies/AccountIDs"
      responses:
        '200':
          description: a list of raw accounts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainRawAccounts'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/accounts/{account_id}/transactions:
    get:
      description: Get account transactions
      operationId: getBlockchainAccountTransactions
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - name: after_lt
          in: query
          description: "omit this parameter to get last transactions"
          schema:
            type: integer
            format: int64
            example: 39787624000003
            x-js-format: bigint
        - name: before_lt
          in: query
          description: "omit this parameter to get last transactions"
          schema:
            type: integer
            format: int64
            example: 39787624000003
            x-js-format: bigint
        - name: limit
          in: query
          schema:
            type: integer
            format: int32
            maximum: 1000
            default: 100
            example: 100
            minimum: 1
        - name: sort_order
          in: query
          schema:
            type: string
            description: "used to sort the result-set in ascending or descending order by lt."
            default: "desc"
            enum:
              - desc
              - asc
      responses:
        '200':
          description: blockchain account transactions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transactions'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/accounts/{account_id}/methods/{method_name}:
    get:
      description: Execute get method for account
      operationId: execGetMethodForBlockchainAccount
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/methodNameParameter'
        - name: args
          in: query
          required: false
          schema:
            type: array
            description: |-
              Array of method arguments in string format. Supported value formats:
              - "NaN" for Not-a-Number type
              - "Null" for Null type
              - Decimal integers for tinyint type (e.g., "100500")
              - 0x-prefixed hex strings for int257 type (e.g., "0xfa01d78381ae32")
              - TON blockchain addresses for slice type (e.g., "0:6e731f2e28b73539a7f85ac47ca104d5840b229351189977bb6151d36b5e3f5e")
              - Base64-encoded BOC for cell type (e.g., "te6ccgEBAQEAAgAAAA==")
              - Hex-encoded BOC for slice type (e.g., "b5ee9c72010101010002000000")
            items:
              type: string
            example: [ "0:9a33970f617bcd71acf2cd28357c067aa31859c02820d8f01d74c88063a8f4d8" ]
      responses:
        '200':
          description: method execution result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MethodExecutionResult'
        'default':
          $ref: '#/components/responses/Error'
    post:
      description: Execute get method for account
      operationId: execGetMethodWithBodyForBlockchainAccount
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/methodNameParameter'
      requestBody:
        $ref: "#/components/requestBodies/ExecGetMethodArgs"
      responses:
        '200':
          description: method execution result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MethodExecutionResult'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/message:
    post:
      description: Send message to blockchain
      operationId: sendBlockchainMessage
      tags:
        - Blockchain
      requestBody:
        $ref: "#/components/requestBodies/BatchBoc"
      responses:
        '200':
          description: the message has been sent
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/config:
    get:
      description: Get blockchain config
      operationId: getBlockchainConfig
      tags:
        - Blockchain
      responses:
        '200':
          description: blockchain config
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainConfig'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/config/raw:
    get:
      description: Get raw blockchain config
      operationId: getRawBlockchainConfig
      tags:
        - Blockchain
      responses:
        '200':
          description: blockchain config
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RawBlockchainConfig'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/accounts/{account_id}/inspect:
    get:
      description: Blockchain account inspect
      operationId: blockchainAccountInspect
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: blockchain account inspect
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainAccountInspect'
        'default':
          $ref: '#/components/responses/Error'
  /v2/blockchain/libraries/{hash}:
    get:
      description: Get library cell
      operationId: getLibraryByHash
      tags:
        - Blockchain
      parameters:
        - $ref: '#/components/parameters/hashParameter'
      responses:
        '200':
          description: library cell
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockchainLibrary'
        'default':
          $ref: '#/components/responses/Error'
  /v2/address/{account_id}/parse:
    get:
      description: parse address and display in all formats
      operationId: addressParse
      tags:
        - Utilities
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: all forms and info
          content:
            application/json:
              schema:
                type: object
                required:
                  - raw_form
                  - bounceable
                  - non_bounceable
                  - given_type
                  - test_only
                properties:
                  raw_form:
                    type: string
                    format: address
                    example: "0:6e731f2e28b73539a7f85ac47ca104d5840b229351189977bb6151d36b5e3f5e"
                  bounceable:
                    required:
                      - b64
                      - b64url
                    type: object
                    properties:
                      b64:
                        type: string
                      b64url:
                        type: string
                  non_bounceable:
                    required:
                      - b64
                      - b64url
                    type: object
                    properties:
                      b64:
                        type: string
                      b64url:
                        type: string
                  given_type:
                    type: string
                  test_only:
                    type: boolean
        default:
          $ref: '#/components/responses/Error'
  /v2/migration/wallets:
    post:
      description: Get migratable assets value (TON balance, jettons with prices, NFT count) for several wallets at once.
      operationId: getMigrationWallets
      tags:
        - Migration
      parameters:
        - $ref: '#/components/parameters/currenciesQuery'
      requestBody:
        $ref: "#/components/requestBodies/AccountIDs"
      responses:
        '200':
          description: migratable value per requested wallet
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MigrationWallets'
        'default':
          $ref: '#/components/responses/Error'
  /v2/migration/prepare:
    post:
      description: Prepare ordered signable transactions that migrate every asset from `from` to `to`.
      operationId: prepareMigration
      tags:
        - Migration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MigrationPrepareRequest'
      responses:
        '200':
          description: ordered transactions to sign and broadcast
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MigrationPrepareResponse'
        '409':
          description: >
            the migration is prepared but not executable as-is — see `error_code`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MigrationPrepareConflict'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/_bulk:
    post:
      description: Get human-friendly information about several accounts without low-level details.
      operationId: getAccounts
      tags:
        - Accounts
      parameters:
        - $ref: "#/components/parameters/currencyQuery"
      requestBody:
        $ref: "#/components/requestBodies/AccountIDs"
      responses:
        '200':
          description: a list of accounts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Accounts'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}:
    get:
      description: Get human-friendly information about an account without low-level details.
      operationId: getAccount
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Account'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/dns/backresolve:
    get:
      description: Get account's domains
      operationId: accountDnsBackResolve
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: account's domains
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainNames'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/jettons:
    get:
      description: Get all Jettons balances by owner address
      operationId: getAccountJettonsBalances
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/currenciesQuery'
        - $ref: '#/components/parameters/supportedExtensions'
        - $ref: '#/components/parameters/limitQuery'
        - $ref: '#/components/parameters/offsetQuery'
      responses:
        '200':
          description: account jettons balances
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JettonsBalances'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/jettons/{jetton_id}:
    get:
      description: Get Jetton balance by owner address
      operationId: getAccountJettonBalance
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/jettonIDParameter'
        - $ref: '#/components/parameters/currenciesQuery'
        - $ref: '#/components/parameters/supportedExtensions'
      responses:
        '200':
          description: account jetton balance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JettonBalance'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/jettons/history:
    get:
      description: Get the transfer jettons history for account
      operationId: getAccountJettonsHistory
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - name: before_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            example: 100
            maximum: 1000
            minimum: 1
      responses:
        '200':
          description: account jettons history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JettonOperations'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/jettons/{jetton_id}/history:
    get:
      deprecated: true
      description: Please use `getJettonAccountHistoryByID`` instead
      operationId: getAccountJettonHistoryByID
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/jettonIDParameter'
        - $ref: '#/components/parameters/i18n'
        - name: before_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            example: 100
            maximum: 1000
            minimum: 1
        - name: start_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: end_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
      responses:
        '200':
          description: account jetton history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountEvents'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/nfts:
    get:
      description: Get all NFT items by owner address
      operationId: getAccountNftItems
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/collectionQuery'
        - $ref: '#/components/parameters/limitQuery'
        - $ref: '#/components/parameters/offsetQuery'
        - in: query
          name: indirect_ownership
          required: false
          description: "Selling nft items in TON implemented usually via transfer items to special selling account. This option enables including items which owned not directly."
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: account nft items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftItems'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/nfts/history:
    get:
      description: Get the transfer nft history
      operationId: getAccountNftHistory
      tags:
        - NFT
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/i18n'
        - name: before_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            example: 100
            maximum: 1000
            minimum: 1
      responses:
        '200':
          description: nft history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftOperations'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/events:
    get:
      description: Get events for an account. Each event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time.
      operationId: getAccountEvents
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/i18n'
        - $ref: '#/components/parameters/initiatorQuery'
        - name: subject_only
          in: query
          description: "filter actions where requested account is not real subject (for example sender or receiver jettons)"
          schema:
            type: boolean
            default: false
          required: false
        - name: after_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: before_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            example: 20
            maximum: 100
            minimum: 1
        - name: start_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: end_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: sort_order
          in: query
          schema:
            type: string
            description: "used to sort the result-set in ascending or descending order by lt."
            default: "desc"
            enum:
              - desc
              - asc
      responses:
        '200':
          description: account's events
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountEvents'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/events/{event_id}:
    get:
      description: Get event for an account by event_id
      operationId: getAccountEvent
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/eventIDParameter'
        - $ref: '#/components/parameters/i18n'
        - name: subject_only
          in: query
          description: "filter actions where requested account is not real subject (for example sender or receiver jettons)"
          schema:
            type: boolean
            default: false
          required: false
      responses:
        '200':
          description: account's event
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountEvent'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/traces:
    get:
      description: Get traces for account
      operationId: getAccountTraces
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - name: before_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          schema:
            type: integer
            maximum: 1000
            default: 100
            example: 100
            minimum: 1
      responses:
        '200':
          description: account's traces
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TraceIDs'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/subscriptions:
    get:
      description: Get all subscriptions by wallet address
      operationId: getAccountSubscriptions
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: account's subscriptions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Subscriptions'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/reindex:
    post:
      description: Update internal cache for a particular account
      operationId: reindexAccount
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: success
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/search:
    get:
      description: Search by account domain name
      operationId: searchAccounts
      tags:
        - Accounts
      parameters:
        - name: name
          in: query
          required: true
          schema:
            type: string
            minLength: 3
            maxLength: 15
      responses:
        '200':
          description: found accounts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FoundAccounts'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/dns/expiring:
    get:
      description: Get expiring account .ton dns
      operationId: getAccountDnsExpiring
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/periodQuery'
      responses:
        '200':
          description: account's expiring .ton dns
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DnsExpiring'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/publickey:
    get:
      description: Get public key by account id
      operationId: getAccountPublicKey
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: account's public key
          content:
            application/json:
              schema:
                type: object
                required:
                  - public_key
                properties:
                  public_key:
                    type: string
                    example: "NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3..."
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/multisigs:
    get:
      description: Get account's multisigs
      operationId: getAccountMultisigs
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: account's multisigs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Multisigs'
        'default':
          $ref: '#/components/responses/Error'
  
  /v2/accounts/{account_id}/diff:
    get:
      description: Get account's balance change
      operationId: getAccountDiff
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - name: start_date
          in: query
          required: true
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: end_date
          in: query
          required: true
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
      responses:
        '200':
          description: account's balance change
          content:
            application/json:
              schema:
                type: object
                required:
                  - balance_change
                properties:
                  balance_change:
                    type: integer
                    format: int64
                    example: 1000000000
        'default':
          $ref: '#/components/responses/Error'
  
  /v2/accounts/{account_id}/defi/assets:
    get:
      description: |
        Return DeFi assets locked in custom smart contracts: currently returns TON Whales staking and EVAA lending positions.
      operationId: getAccountDefiAssets
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: account's DeFi assets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefiAssets'
        'default':
          $ref: '#/components/responses/Error'

  /v2/accounts/{account_id}/extra-currency/{id}/history:
    get:
      description: Get the transfer history of extra currencies for an account.
      operationId: getAccountExtraCurrencyHistoryByID
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/ecIDParameter'
        - $ref: '#/components/parameters/i18n'
        - name: before_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            example: 100
            maximum: 1000
            minimum: 1
        - name: start_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: end_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
      responses:
        '200':
          description: account extra currency history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountEvents'
        'default':
          $ref: '#/components/responses/Error'
  
  /v2/dns/{domain_name}:
    get:
      description: Get full information about domain name
      operationId: getDnsInfo
      tags:
        - DNS
      parameters:
        - $ref: '#/components/parameters/domainNameParameter'
      responses:
        '200':
          description: domain info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainInfo'
        'default':
          $ref: '#/components/responses/Error'
  /v2/dns/{domain_name}/resolve:
    get:
      description: DNS resolve for domain name
      operationId: dnsResolve
      tags:
        - DNS
      parameters:
        - $ref: '#/components/parameters/domainNameParameter'
        - name: filter
          in: query
          schema:
            type: boolean
            default: false
          required: false
      responses:
        '200':
          description: dns record
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DnsRecord'
        'default':
          $ref: '#/components/responses/Error'
  /v2/dns/{domain_name}/bids:
    get:
      description: Get domain bids
      operationId: getDomainBids
      tags:
        - DNS
      parameters:
        - $ref: '#/components/parameters/domainNameParameter'
      responses:
        '200':
          description: domain bids
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainBids'
        'default':
          $ref: '#/components/responses/Error'
  /v2/dns/auctions:
    get:
      description: Get all auctions
      operationId: getAllAuctions
      tags:
        - DNS
      parameters:
        - $ref: '#/components/parameters/domainFilterQuery'
      responses:
        '200':
          description: auctions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Auctions'
        'default':
          $ref: '#/components/responses/Error'

  /v2/nfts/collections:
    get:
      description: Get NFT collections
      operationId: getNftCollections
      tags:
        - NFT
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            format: int32
            maximum: 1000
            default: 100
            example: 15
            minimum: 1
        - name: offset
          in: query
          schema:
            type: integer
            format: int32
            default: 0
            example: 10
            minimum: 0
      responses:
        '200':
          description: nft collections
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftCollections'
        'default':
          $ref: '#/components/responses/Error'
  /v2/nfts/collections/{account_id}:
    get:
      description: Get NFT collection by collection address
      operationId: getNftCollection
      tags:
        - NFT
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: nft collection
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftCollection'
        'default':
          $ref: '#/components/responses/Error'
  /v2/nfts/collections/_bulk:
    post:
      description: Get NFT collection items by their addresses
      operationId: getNftCollectionItemsByAddresses
      tags:
        - NFT
      requestBody:
        $ref: "#/components/requestBodies/AccountIDs"
      responses:
        '200':
          description: nft collections
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftCollections'
        'default':
          $ref: '#/components/responses/Error'
  /v2/nfts/collections/{account_id}/items:
    get:
      description: Get NFT items from collection by collection address
      operationId: getItemsFromCollection
      tags:
        - NFT
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/limitQuery'
        - $ref: '#/components/parameters/offsetQuery'
      responses:
        '200':
          description: nft items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftItems'
        'default':
          $ref: '#/components/responses/Error'
  /v2/nfts/_bulk:
    post:
      description: Get NFT items by their addresses
      operationId: getNftItemsByAddresses
      tags:
        - NFT
      requestBody:
        $ref: "#/components/requestBodies/AccountIDs"
      responses:
        '200':
          description: nft items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftItems'
        'default':
          $ref: '#/components/responses/Error'
  /v2/nfts/{account_id}:
    get:
      description: Get NFT item by its address
      operationId: getNftItemByAddress
      tags:
        - NFT
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: nft item
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftItem'
        'default':
          $ref: '#/components/responses/Error'
  /v2/nfts/{account_id}/history:
    get:
      deprecated: true
      description: Please use `getAccountNftHistory`` instead
      operationId: getNftHistoryByID
      tags:
        - NFT
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/i18n'
        - name: before_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            example: 100
            maximum: 1000
            minimum: 1
        - name: start_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: end_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
      responses:
        '200':
          description: nft history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountEvents'
        'default':
          $ref: '#/components/responses/Error'
  /v2/traces/{trace_id}:
    get:
      description: Get the trace by trace ID or hash of any transaction in trace
      operationId: getTrace
      tags:
        - Traces
      parameters:
        - $ref: '#/components/parameters/traceIDParameter'
      responses:
        '200':
          description: trace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Trace'
        'default':
          $ref: '#/components/responses/Error'

  /v2/events/{event_id}:
    get:
      description: Get an event either by event ID or a hash of any transaction in a trace. An event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time.
      operationId: getEvent
      tags:
        - Events
      parameters:
        - $ref: '#/components/parameters/eventIDParameter'
        - $ref: '#/components/parameters/i18n'
      responses:
        '200':
          description: event
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        'default':
          $ref: '#/components/responses/Error'

  /v2/jettons:
    get:
      description: Get a list of all indexed jetton masters in the blockchain.
      operationId: getJettons
      tags:
        - Jettons
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            format: int32
            maximum: 1000
            default: 100
            example: 15
            minimum: 1
        - name: offset
          in: query
          description: >-
            Deprecated: pagination is based on a daily snapshot, so some new jettons may not appear yet.
            Use `last_account_id` for real-time pagination instead.
          schema:
            type: integer
            format: int32
            default: 0
            example: 10
            minimum: 0
        - name: last_account_id
          in: query
          description: >-
            Cursor for pagination, always resolved live. Pass the `metadata.address` of the last jetton master
            from the previous page to get the next page. Preferred over `offset`.
          schema:
            type: string
            format: address
            example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
      responses:
        '200':
          description: a list of jettons
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Jettons'
        'default':
          $ref: '#/components/responses/Error'
  /v2/jettons/{account_id}:
    get:
      description: Get jetton metadata by jetton master address
      operationId: getJettonInfo
      tags:
        - Jettons
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: jetton info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JettonInfo'
        'default':
          $ref: '#/components/responses/Error'
  /v2/jettons/_bulk:
    post:
      description: Get jetton metadata items by jetton master addresses
      operationId: getJettonInfosByAddresses
      tags:
        - Jettons
      requestBody:
        $ref: "#/components/requestBodies/AccountIDs"
      responses:
        '200':
          description: a list of jettons
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Jettons'
        'default':
          $ref: '#/components/responses/Error'
  /v2/jettons/{account_id}/holders:
    get:
      description: Get jetton's holders
      operationId: getJettonHolders
      tags:
        - Jettons
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/limitQuery'
        - in: query
          name: offset
          description: "used only with sort_by=balance; has limit of 9000 rows"
          required: false
          schema:
            type: integer
            default: 0
            minimum: 0
        - in: query
          name: sort_by
          required: false
          schema:
            type: string
            description: "address allows unlimited pagination via last_account_id cursor, balance sorting allow getting top holders"
            default: "balance"
            enum:
              - balance
              - address
        - in: query
          name: last_account_id
          description: "used only with sort_by=address: the account_id of the last holder from the previous page, to fetch the next page after it"
          required: false
          schema:
            type: string
            format: address
            example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
      responses:
        '200':
          description: jetton's holders
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JettonHolders'
        'default':
          $ref: '#/components/responses/Error'
  /v2/jettons/{jetton_id}/transfer/{account_id}/payload:
    get:
      description: Get jetton's custom payload and state init required for transfer
      operationId: getJettonTransferPayload
      tags:
        - Jettons
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/jettonIDParameter'
      responses:
        '200':
          description: jetton's custom payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JettonTransferPayload'
        'default':
          $ref: '#/components/responses/Error'
  /v2/events/{event_id}/jettons:
    get:
      description: "Get only jetton transfers in the event"
      operationId: getJettonsEvents
      tags:
        - Jettons
      parameters:
        - $ref: '#/components/parameters/eventIDParameter'
        - $ref: '#/components/parameters/i18n'
      responses:
        '200':
          description: events
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        'default':
          $ref: '#/components/responses/Error'
  /v2/jettons/{jetton_id}/accounts/{account_id}/history:
    get:
      description: Get the transfer jetton history for account and jetton
      operationId: getJettonAccountHistoryByID
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/jettonIDParameter'
        - name: before_lt
          in: query
          description: "omit this parameter to get last events"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            example: 100
            maximum: 1000
            minimum: 1
        - name: start_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: end_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
      responses:
        '200':
          description: account jetton history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JettonOperations'
        'default':
          $ref: '#/components/responses/Error'
  
  /v2/extra-currency/{id}:
    get:
      description: Get extra currency info by id
      operationId: getExtraCurrencyInfo
      tags:
        - ExtraCurrency
      parameters:
        - $ref: '#/components/parameters/ecIDParameter'
      responses:
        '200':
          description: extra currency info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcPreview'
        'default':
          $ref: '#/components/responses/Error'

  /v2/staking/nominator/{account_id}/pools:
    get:
      description: All pools where account participates
      operationId: getAccountNominatorsPools
      tags:
        - Staking
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: account's pools
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountStaking'
        'default':
          $ref: '#/components/responses/Error'
  /v2/staking/pool/{account_id}:
    get:
      description: Stacking pool info
      operationId: getStakingPoolInfo
      tags:
        - Staking
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/i18n'
      responses:
        '200':
          description: stacking pool info
          content:
            application/json:
              schema:
                type: object
                required:
                  - implementation
                  - pool
                properties:
                  implementation:
                    $ref: '#/components/schemas/PoolImplementation'
                  pool:
                    $ref: '#/components/schemas/PoolInfo'
        'default':
          $ref: '#/components/responses/Error'
  /v2/staking/pool/{account_id}/history:
    get:
      description: Pool history
      operationId: getStakingPoolHistory
      tags:
        - Staking
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - name: before_lt
          in: query
          description: "omit this parameter to get last log entries"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 100
            maximum: 100
            minimum: 1
            example: 100
      responses:
        '200':
          description: pool history
          content:
            application/json:
              schema:
                type: object
                required:
                  - apy
                properties:
                  apy:
                    type: array
                    items:
                      $ref: '#/components/schemas/ApyHistory'
        'default':
          $ref: '#/components/responses/Error'
  /v2/staking/pools:
    get:
      description: All pools available in network
      operationId: getStakingPools
      tags:
        - Staking
      parameters:
        - in: query
          name: available_for
          required: false
          description: account ID
          schema:
            type: string
            format: address
            example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
        - in: query
          name: include_unverified
          required: false
          description: "return also pools not from white list - just compatible by interfaces (maybe dangerous!)"
          schema:
            type: boolean
            example: false
        - $ref: '#/components/parameters/i18n'
      responses:
        '200':
          description: a list of pools
          content:
            application/json:
              schema:
                type: object
                required:
                  - pools
                  - implementations
                properties:
                  pools:
                    type: array
                    items:
                      $ref: '#/components/schemas/PoolInfo'
                  implementations:
                    type: object
                    additionalProperties:
                      $ref: '#/components/schemas/PoolImplementation'
        'default':
          $ref: '#/components/responses/Error'

  /v2/storage/providers:
    get:
      description: Get TON storage providers deployed to the blockchain.
      operationId: getStorageProviders
      tags:
        - Storage
      responses:
        '200':
          description: a list of storage providers
          content:
            application/json:
              schema:
                type: object
                required:
                  - providers
                properties:
                  providers:
                    type: array
                    items:
                      $ref: '#/components/schemas/StorageProvider'
        'default':
          $ref: '#/components/responses/Error'
  
  /v2/rates:
    get:
      description: Get the token price in the chosen currency for display only. Don’t use this for financial transactions.
      operationId: getRates
      tags:
        - Rates
      parameters:
        - in: query
          name: tokens
          description: accept gram and jetton master addresses, separated by commas
          required: true
          explode: false
          schema:
            type: array
            maxItems: 100
            items:
              type: string
              format: address
            example: [ "gram" ]
        - in: query
          name: currencies
          description: accept gram and all possible fiat currencies, separated by commas
          required: true
          explode: false
          schema:
            type: array
            maxItems: 50
            items:
              type: string
            example: [ "gram","usd","rub" ]
      responses:
        '200':
          description: tokens rates
          content:
            application/json:
              schema:
                type: object
                required:
                  - rates
                properties:
                  rates:
                    type: object
                    additionalProperties:
                      $ref: '#/components/schemas/TokenRates'
        'default':
          $ref: '#/components/responses/Error'
  /v2/rates/chart:
    get:
      description: Get chart by token
      operationId: getChartRates
      tags:
        - Rates
      parameters:
        - in: query
          name: token
          description: accept jetton master address
          required: true
          schema:
            type: string
            format: address
        - in: query
          name: currency
          required: false
          schema:
            type: string
            example: usd
        - name: start_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: end_date
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maximum: 2114380800
            example: 1668436763
        - name: points_count
          in: query
          required: false
          schema:
            type: integer
            format: int
            maximum: 200
            minimum: 0
            default: 200
      responses:
        '200':
          description: token chart
          content:
            application/json:
              schema:
                type: object
                required:
                  - points
                properties:
                  points:
                    $ref: '#/components/schemas/ChartPoints'
        'default':
          $ref: '#/components/responses/Error'
  /v2/rates/markets:
    get:
      description: Get the Gram price from markets
      operationId: getMarketsRates
      tags:
        - Rates
      responses:
        '200':
          description: markets rates
          content:
            application/json:
              schema:
                type: object
                required:
                  - markets
                properties:
                  markets:
                    type: array
                    items:
                      $ref: '#/components/schemas/MarketTonRates'
        'default':
          $ref: '#/components/responses/Error'
  
  /v2/tonconnect/payload:
    get:
      description: Get a payload for further token receipt
      operationId: getTonConnectPayload
      tags:
        - Connect
      responses:
        '200':
          description: payload
          content:
            application/json:
              schema:
                type: object
                required:
                  - payload
                properties:
                  payload:
                    type: string
                    example: "84jHVNLQmZsAAAAAZB0Zryi2wqVJI-KaKNXOvCijEi46YyYzkaSHyJrMPBMOkVZa"
        'default':
          $ref: '#/components/responses/Error'
  /v2/tonconnect/stateinit:
    post:
      description: Get account info by state init
      operationId: getAccountInfoByStateInit
      tags:
        - Connect
      requestBody:
        $ref: "#/components/requestBodies/TonConnectStateInit"
      responses:
        '200':
          description: account info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountInfoByStateInit'
        'default':
          $ref: '#/components/responses/Error'
  /v2/wallet/auth/proof:
    post:
      description: Account verification and token issuance
      operationId: tonConnectProof
      tags:
        - Wallet
      requestBody:
        $ref: "#/components/requestBodies/TonConnectProof"
      responses:
        '200':
          description: auth token
          content:
            application/json:
              schema:
                type: object
                required:
                  - token
                properties:
                  token:
                    type: string
                    example: "NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3..."
        'default':
          $ref: '#/components/responses/Error'
  /v2/wallet/{account_id}/seqno:
    get:
      description: Get account seqno
      operationId: getAccountSeqno
      tags:
        - Wallet
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: account seqno
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Seqno'
        'default':
          $ref: '#/components/responses/Error'
  /v2/wallet/{account_id}:
    get:
      description: Get human-friendly information about a wallet without low-level details.
      operationId: getWalletInfo
      tags:
        - Wallet
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: wallet
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Wallet'
        'default':
          $ref: '#/components/responses/Error'
  /v2/gasless/config:
    get:
      description: Returns configuration of gasless transfers
      operationId: gaslessConfig
      tags:
        - Gasless
      responses:
        '200':
          description: "gasless config"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GaslessConfig'
        'default':
          $ref: '#/components/responses/Error'
  /v2/gasless/estimate/{master_id}:
    post:
      description: Estimates the cost of the given messages and returns a payload to sign
      operationId: gaslessEstimate
      parameters:
        - $ref: '#/components/parameters/i18n'
        - name: master_id
          in: path
          required: true
          description: jetton to pay commission
          schema:
            type: string
            format: address
            example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
      tags:
        - Gasless
      requestBody:
        $ref: "#/components/requestBodies/InternalMessages"
      responses:
        '200':
          description: "payload to sign"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SignRawParams'
        'default':
          $ref: '#/components/responses/Error'
  /v2/gasless/send:
    post:
      description: Submits the signed gasless transaction message to the network
      operationId: gaslessSend
      tags:
        - Gasless
      requestBody:
        $ref: "#/components/requestBodies/GaslessSend"
      responses:
        '200':
          description: the message has been sent
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GaslessTx'
        'default':
          $ref: '#/components/responses/Error'
  /v2/pubkeys/{public_key}/wallets:
    get:
      description: Get wallets by public key
      operationId: getWalletsByPublicKey
      tags:
        - Wallet
      parameters:
        - $ref: '#/components/parameters/publicKeyParameter'
      responses:
        '200':
          description: a list of wallets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Wallets'
        'default':
          $ref: '#/components/responses/Error'
  /v2/pubkeys/wallets/_bulk:
    post:
      description: Get wallets by a list of public keys
      operationId: getWalletsByPublicKeyBulk
      tags:
        - Wallet
      requestBody:
        $ref: '#/components/requestBodies/PublicKeys'
      responses:
        '200':
          description: grouped wallets per public key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletsByPublicKeys'
        'default':
          $ref: '#/components/responses/Error'

  /v2/liteserver/get_masterchain_info:
    get:
      description: Get raw masterchain info
      operationId: getRawMasterchainInfo
      tags:
        - Lite Server
      responses:
        '200':
          description: raw masterchain info
          content:
            application/json:
              schema:
                type: object
                required:
                  - last
                  - state_root_hash
                  - init
                properties:
                  last:
                    $ref: '#/components/schemas/BlockRaw'
                  state_root_hash:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  init:
                    $ref: '#/components/schemas/InitStateRaw'
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_masterchain_info_ext:
    get:
      description: Get raw masterchain info ext
      operationId: getRawMasterchainInfoExt
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/modeQuery'
      responses:
        '200':
          description: raw masterchain info ext
          content:
            application/json:
              schema:
                type: object
                required:
                  - mode
                  - version
                  - capabilities
                  - last
                  - last_utime
                  - now
                  - state_root_hash
                  - init
                properties:
                  mode:
                    type: integer
                    format: int32
                    example: 0
                  version:
                    type: integer
                    format: int32
                    example: 257
                  capabilities:
                    type: integer
                    format: int64
                    example: 7
                  last:
                    $ref: '#/components/schemas/BlockRaw'
                  last_utime:
                    type: integer
                    format: int32
                    example: 1687938199
                  now:
                    type: integer
                    format: int32
                    example: 1687938204
                  state_root_hash:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  init:
                    $ref: '#/components/schemas/InitStateRaw'
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_time:
    get:
      description: Get raw time
      operationId: getRawTime
      tags:
        - Lite Server
      responses:
        '200':
          description: raw time
          content:
            application/json:
              schema:
                type: object
                required:
                  - time
                properties:
                  time:
                    type: integer
                    format: int32
                    example: 1687146728
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_block/{block_id}:
    get:
      description: Get raw blockchain block
      operationId: getRawBlockchainBlock
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDExtParameter'
      responses:
        '200':
          description: raw blockchain block
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - data
                properties:
                  id:
                    $ref: '#/components/schemas/BlockRaw'
                  data:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_state/{block_id}:
    get:
      description: Get raw blockchain block state
      operationId: getRawBlockchainBlockState
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDExtParameter'
      responses:
        '200':
          description: raw blockchain block state
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - root_hash
                  - file_hash
                  - data
                properties:
                  id:
                    $ref: '#/components/schemas/BlockRaw'
                  root_hash:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  file_hash:
                    type: string
                    example: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
                  data:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_block_header/{block_id}:
    get:
      description: Get raw blockchain block header
      operationId: getRawBlockchainBlockHeader
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDExtParameter'
        - $ref: '#/components/parameters/modeQuery'
      responses:
        '200':
          description: raw blockchain block header
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - mode
                  - header_proof
                properties:
                  id:
                    $ref: '#/components/schemas/BlockRaw'
                  mode:
                    type: integer
                    format: int32
                    example: 0
                  header_proof:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/send_message:
    post:
      description: Send raw message to blockchain
      operationId: sendRawMessage
      tags:
        - Lite Server
      requestBody:
        $ref: "#/components/requestBodies/LiteServerSendMessageRequest"
      responses:
        '200':
          description: code
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                properties:
                  code:
                    type: integer
                    format: int32
                    example: 200
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_account_state/{account_id}:
    get:
      description: Get raw account state
      operationId: getRawAccountState
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/targetBlockIDExtQuery'
      responses:
        '200':
          description: raw account state
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - shardblk
                  - shard_proof
                  - proof
                  - state
                properties:
                  id:
                    $ref: '#/components/schemas/BlockRaw'
                  shardblk:
                    $ref: '#/components/schemas/BlockRaw'
                  shard_proof:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  proof:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  state:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_shard_info/{block_id}:
    get:
      description: Get raw shard info
      operationId: getRawShardInfo
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDExtParameter'
        - $ref: '#/components/parameters/workchainQuery'
        - $ref: '#/components/parameters/shardQuery'
        - $ref: '#/components/parameters/exactQuery'
      responses:
        '200':
          description: raw shard info
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - shardblk
                  - shard_proof
                  - shard_descr
                properties:
                  id:
                    $ref: '#/components/schemas/BlockRaw'
                  shardblk:
                    $ref: '#/components/schemas/BlockRaw'
                  shard_proof:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  shard_descr:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_all_shards_info/{block_id}:
    get:
      description: Get all raw shards info
      operationId: getAllRawShardsInfo
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDExtParameter'
      responses:
        '200':
          description: all raw shards info
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - proof
                  - data
                properties:
                  id:
                    $ref: '#/components/schemas/BlockRaw'
                  proof:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  data:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_transactions/{account_id}:
    get:
      description: Get raw transactions
      operationId: getRawTransactions
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - $ref: '#/components/parameters/countQuery'
        - $ref: '#/components/parameters/ltMustQuery'
        - $ref: '#/components/parameters/hashQuery'
      responses:
        '200':
          description: raw transactions
          content:
            application/json:
              schema:
                type: object
                required:
                  - ids
                  - transactions
                properties:
                  ids:
                    type: array
                    items:
                      $ref: '#/components/schemas/BlockRaw'
                  transactions:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/list_block_transactions/{block_id}:
    get:
      description: Get raw list block transactions
      operationId: getRawListBlockTransactions
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDExtParameter'
        - $ref: '#/components/parameters/modeQuery'
        - $ref: '#/components/parameters/countQuery'
        - $ref: '#/components/parameters/accountIDQuery'
        - $ref: '#/components/parameters/ltQuery'
      responses:
        '200':
          description: a list of raw block transactions
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - req_count
                  - incomplete
                  - ids
                  - proof
                properties:
                  id:
                    $ref: '#/components/schemas/BlockRaw'
                  req_count:
                    type: integer
                    format: int32
                    example: 100
                  incomplete:
                    type: boolean
                    example: true
                  ids:
                    type: array
                    items:
                      type: object
                      required:
                        - mode
                      properties:
                        mode:
                          type: integer
                          format: int32
                          example: 0
                        account:
                          type: string
                          example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                        lt:
                          type: integer
                          format: int64
                          x-js-format: bigint
                        hash:
                          type: string
                          example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  proof:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_block_proof:
    get:
      description: Get raw block proof
      operationId: getRawBlockProof
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/knownBlockIDExtQuery'
        - $ref: '#/components/parameters/targetBlockIDExtQuery'
        - $ref: '#/components/parameters/modeQuery'
      responses:
        '200':
          description: raw block proof
          content:
            application/json:
              schema:
                type: object
                required:
                  - complete
                  - from
                  - to
                  - steps
                properties:
                  complete:
                    type: boolean
                    example: true
                  from:
                    $ref: '#/components/schemas/BlockRaw'
                  to:
                    $ref: '#/components/schemas/BlockRaw'
                  steps:
                    type: array
                    items:
                      type: object
                      required:
                        - lite_server_block_link_back
                        - lite_server_block_link_forward
                      properties:
                        lite_server_block_link_back:
                          type: object
                          required:
                            - to_key_block
                            - from
                            - to
                            - dest_proof
                            - proof
                            - state_proof
                          properties:
                            to_key_block:
                              type: boolean
                              example: false
                            from:
                              $ref: '#/components/schemas/BlockRaw'
                            to:
                              $ref: '#/components/schemas/BlockRaw'
                            dest_proof:
                              type: string
                              example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                            proof:
                              type: string
                              example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                            state_proof:
                              type: string
                              example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                        lite_server_block_link_forward:
                          type: object
                          required:
                            - to_key_block
                            - from
                            - to
                            - dest_proof
                            - config_proof
                            - signatures
                          properties:
                            to_key_block:
                              type: boolean
                              example: false
                            from:
                              $ref: '#/components/schemas/BlockRaw'
                            to:
                              $ref: '#/components/schemas/BlockRaw'
                            dest_proof:
                              type: string
                              example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                            config_proof:
                              type: string
                              example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                            signatures:
                              type: object
                              required:
                                - validator_set_hash
                                - catchain_seqno
                                - signatures
                              properties:
                                validator_set_hash:
                                  type: integer
                                  format: int64
                                catchain_seqno:
                                  type: integer
                                  format: int32
                                signatures:
                                  type: array
                                  items:
                                    type: object
                                    required:
                                      - node_id_short
                                      - signature
                                    properties:
                                      node_id_short:
                                        type: string
                                        example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                                      signature:
                                        type: string
                                        example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_config_all/{block_id}:
    get:
      description: Get raw config
      operationId: getRawConfig
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDExtParameter'
        - $ref: '#/components/parameters/modeQuery'
      responses:
        '200':
          description: raw config
          content:
            application/json:
              schema:
                type: object
                required:
                  - mode
                  - id
                  - state_proof
                  - config_proof
                properties:
                  mode:
                    type: integer
                    format: int32
                    example: 0
                  id:
                    $ref: '#/components/schemas/BlockRaw'
                  state_proof:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
                  config_proof:
                    type: string
                    example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_shard_block_proof/{block_id}:
    get:
      description: Get raw shard block proof
      operationId: getRawShardBlockProof
      tags:
        - Lite Server
      parameters:
        - $ref: '#/components/parameters/blockchainBlockIDExtParameter'
      responses:
        '200':
          description: raw shard block proof
          content:
            application/json:
              schema:
                type: object
                required:
                  - masterchain_id
                  - links
                properties:
                  masterchain_id:
                    $ref: '#/components/schemas/BlockRaw'
                  links:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - proof
                      properties:
                        id:
                          $ref: '#/components/schemas/BlockRaw'
                        proof:
                          type: string
                          example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        'default':
          $ref: '#/components/responses/Error'
  /v2/liteserver/get_out_msg_queue_sizes:
    get:
      description: Get out msg queue sizes
      operationId: getOutMsgQueueSizes
      tags:
        - Lite Server
      responses:
        '200':
          description: out msg queue sizes
          content:
            application/json:
              schema:
                type: object
                required:
                  - ext_msg_queue_size_limit
                  - shards
                properties:
                  ext_msg_queue_size_limit:
                    type: integer
                    format: uint32
                  shards:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - size
                      properties:
                        id:
                          $ref: '#/components/schemas/BlockRaw'
                        size:
                          type: integer
                          format: uint32
        'default':
          $ref: '#/components/responses/Error'

  /v2/multisig/{account_id}:
    get:
      description: Get multisig account info
      operationId: getMultisigAccount
      tags:
        - Multisig
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: multisig account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Multisig'
        'default':
          $ref: '#/components/responses/Error'

  /v2/multisig/order/{account_id}:
    get:
      description: Get multisig order
      operationId: getMultisigOrder
      tags:
        - Multisig
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
      responses:
        '200':
          description: multisig order
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MultisigOrder'
        'default':
          $ref: '#/components/responses/Error'

  /v2/message/decode:
    post:
      description: Decode a given message. Only external incoming messages can be decoded currently.
      operationId: decodeMessage
      tags:
        - Emulation
      requestBody:
        $ref: "#/components/requestBodies/Boc"
      responses:
        '200':
          description: decoded message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecodedMessage'
        'default':
          $ref: '#/components/responses/Error'
  /v2/events/emulate:
    post:
      description: Emulate sending message to retrieve general blockchain events
      operationId: emulateMessageToEvent
      tags:
        - Emulation
        - Events
      parameters:
        - $ref: '#/components/parameters/i18n'
        - name: ignore_signature_check
          in: query
          required: false
          schema:
            type: boolean
      requestBody:
        $ref: "#/components/requestBodies/Boc"
      responses:
        '200':
          description: emulated event
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        'default':
          $ref: '#/components/responses/Error'
  /v2/traces/emulate:
    post:
      description: Emulate sending message to retrieve with a detailed execution trace
      operationId: emulateMessageToTrace
      tags:
        - Emulation
        - Traces
      parameters:
        - name: ignore_signature_check
          in: query
          required: false
          schema:
            type: boolean
      requestBody:
        $ref: "#/components/requestBodies/Boc"
      responses:
        '200':
          description: emulated trace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Trace'
        'default':
          $ref: '#/components/responses/Error'
  /v2/wallet/emulate:
    post:
      description: Emulates a wallet message on the current blockchain state and derives its consequences for the signing wallet
      operationId: emulateMessageToWallet
      tags:
        - Emulation
        - Wallet
      parameters:
        - $ref: '#/components/parameters/i18n'
        - $ref: '#/components/parameters/currencyQuery'
      requestBody:
        $ref: "#/components/requestBodies/EmulationBoc"
      responses:
        '200':
          description: Emulated wallet message consequences
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageConsequences'
        'default':
          $ref: '#/components/responses/Error'
  /v2/accounts/{account_id}/events/emulate:
    post:
      description: Emulate sending message to retrieve account-specific events
      operationId: emulateMessageToAccountEvent
      tags:
        - Emulation
        - Accounts
      parameters:
        - $ref: '#/components/parameters/i18n'
        - $ref: '#/components/parameters/accountIDParameter'
        - name: ignore_signature_check
          in: query
          required: false
          schema:
            type: boolean
      requestBody:
        $ref: "#/components/requestBodies/Boc"
      responses:
        '200':
          description: emulated message to account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountEvent'
        'default':
          $ref: '#/components/responses/Error'
  /v2/purchases/{account_id}/history:
    get:
      description: Get history of purchases
      operationId: getPurchaseHistory
      tags:
        - Purchases
      parameters:
        - $ref: '#/components/parameters/accountIDParameter'
        - name: before_lt
          in: query
          description: "omit this parameter to get last invoices"
          required: false
          schema:
            type: integer
            format: int64
            example: 25758317000002
            x-js-format: bigint
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 100
            example: 100
            maximum: 1000
            minimum: 1
      responses:
        '200':
          description: account purchase history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountPurchases'
        'default':
          $ref: '#/components/responses/Error'
  /v2/rewards/validators:
    get:
      operationId: getValidators
      tags:
        - Rewards
      summary: Get all current validators
      description: >
        Returns all current validators with stakes, rewards, pool addresses,
        and (optionally) nominator breakdowns.
      parameters:
        - name: seqno
          in: query
          description: >
            Masterchain block seqno. Defaults to latest.
            Mutually exclusive with `unixtime`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: unixtime
          in: query
          description: >
            Unix timestamp (seconds). Looks up the masterchain block at this
            time and uses it as the anchor. Mutually exclusive with `seqno`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: shallow
          in: query
          description: >
            Set to `1` to return only basic validator info (rank, pubkey,
            effective_stake, weight, reward, pool). Skips pool type detection,
            owner/validator addresses, nominator data, and returned-stake
            lookup — significantly faster.
          required: false
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ValidatorsResponse"
        'default':
          $ref: '#/components/responses/Error'
  /v2/rewards/validation-rounds:
    get:
      operationId: getValidationRounds
      tags:
        - Rewards
      summary: Get validation round metadata
      description: >
        Returns past and current validation rounds with boundaries, stakes,
        and bonuses. Always uses the latest masterchain block.
      parameters:
        - name: election_id
          in: query
          description: >
            Return the single round matching this election ID.
            Mutually exclusive with `block` and `unixtime`.
          required: false
          schema:
            type: integer
            format: int64
        - name: block
          in: query
          description: >
            Find the round containing this masterchain block seqno and return
            it plus up to `limit-1` older rounds. Mutually exclusive with
            `election_id` and `unixtime`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: unixtime
          in: query
          description: >
            Unix timestamp (seconds). Looks up the masterchain block at this
            time and uses it as the anchor. Mutually exclusive with
            `election_id` and `block`.
          required: false
          schema:
            type: integer
            format: uint32
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ValidationRoundsResponse"
        'default':
          $ref: '#/components/responses/Error'
  /v2/rewards/round-rewards:
    get:
      operationId: getRoundRewards
      tags:
        - Rewards
      summary: Get per-validator reward distribution for a finished round
      description: >
        Computes per-validator and per-nominator reward distribution for a
        finished validation round using the elector's bonuses value.
      parameters:
        - name: election_id
          in: query
          description: >
            Election ID of the finished round. Mutually exclusive with `block` and `unixtime`.
          required: false
          schema:
            type: integer
            format: int64
        - name: block
          in: query
          description: >
            Masterchain block seqno within the finished round.
            Mutually exclusive with `election_id` and `unixtime`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: unixtime
          in: query
          description: >
            Unix timestamp (seconds). Looks up the masterchain block at this
            time and uses it as the anchor. Mutually exclusive with
            `election_id` and `block`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: shallow
          in: query
          description: >
            Set to `1` to return only basic validator info (rank, pubkey,
            effective_stake, weight, reward, pool). Skips pool type detection,
            owner/validator addresses, nominator data, and returned-stake
            lookup — significantly faster.
          required: false
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RoundRewardsResponse"
        'default':
          $ref: '#/components/responses/Error'
  /v2/rewards/stats:
    get:
      operationId: getRewardsStats
      tags:
        - Rewards
      summary: Get historical APY and stake statistics
      description: Returns time series of APY and total stake from past validation rounds.
      responses:
        '200':
          description: APY and stake statistics
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RewardsStats'
        'default':
          $ref: '#/components/responses/Error'
  /v2/rewards/apy:
    get:
      operationId: getRewardsApy
      tags:
        - Rewards
      summary: Get current TON blockchain APY
      description: Returns the current TON blockchain APY as a percent based on the latest completed validation round.
      responses:
        '200':
          description: current TON blockchain APY as a percent
          content:
            application/json:
              schema:
                type: number
                format: double
                example: 3.3
        'default':
          $ref: '#/components/responses/Error'
components:
  parameters:
    masterchainSeqno:
      in: path
      name: masterchain_seqno
      required: true
      description: "masterchain block seqno"
      schema:
        type: integer
        format: int32
        example: 123456
    blockchainBlockIDParameter:
      in: path
      name: block_id
      required: true
      description: block ID
      schema:
        type: string
        example: (-1,8000000000000000,4234234)
    blockchainBlockIDExtParameter:
      in: path
      name: block_id
      required: true
      description: "block ID: (workchain,shard,seqno,root_hash,file_hash)"
      schema:
        type: string
        example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
    transactionIDParameter:
      in: path
      name: transaction_id
      required: true
      description: transaction ID
      schema:
        type: string
        example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    messageIDParameter:
      in: path
      name: msg_id
      required: true
      description: message ID
      schema:
        type: string
        example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    accountIDParameter:
      in: path
      name: account_id
      required: true
      description: account ID
      schema:
        type: string
        format: address
        example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    accountIDParameters:
      in: path
      name: account_ids
      required: true
      description: account ID
      explode: false
      schema:
        type: array
        items:
          type: string
          format: address
          example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    jettonIDParameter:
      in: path
      name: jetton_id
      required: true
      description: jetton ID
      schema:
        type: string
        format: address
        example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    methodNameParameter:
      in: path
      name: method_name
      required: true
      description: contract get method name
      schema:
        type: string
        example: get_wallet_address
    domainNameParameter:
      in: path
      name: domain_name
      required: true
      description: domain name with .ton or .t.me
      schema:
        type: string
        example: wallet.ton
    traceIDParameter:
      in: path
      name: trace_id
      required: true
      description: "trace ID or transaction hash in hex (without 0x) or base64url format"
      schema:
        type: string
        example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    eventIDParameter:
      in: path
      name: event_id
      required: true
      description: "event ID or transaction hash in hex (without 0x) or base64url format"
      schema:
        type: string
        example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    ecIDParameter:
      in: path
      name: id
      required: true
      description: "extra currency id"
      schema:
        type: integer
        example: 239
        format: int32
    publicKeyParameter:
      in: path
      name: public_key
      required: true
      schema:
        type: string
        example: NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3...
    hashParameter:
      in: path
      name: hash
      required: true
      description: "hash in hex (without 0x) format"
      schema:
        type: string
        example: "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
    i18n:
      in: header
      name: Accept-Language
      required: false
      schema:
        type: string
        example: "ru-RU,ru;q=0.5"
        default: "en"
    limitQuery:
      in: query
      name: limit
      required: false
      schema:
        type: integer
        default: 1000
        maximum: 1000
        minimum: 1
    offsetQuery:
      in: query
      name: offset
      required: false
      schema:
        type: integer
        default: 0
        minimum: 0
    domainFilterQuery:
      in: query
      name: tld
      required: false
      description: domain filter for current auctions "ton" or "t.me"
      schema:
        type: string
        example: ton
    periodQuery:
      in: query
      name: period
      required: false
      description: "number of days before expiration"
      schema:
        type: integer
        minimum: 1
        maximum: 3660
    collectionQuery:
      in: query
      name: collection
      required: false
      description: "nft collection"
      schema:
        type: string
        format: address
        example: "0:06d811f426598591b32b2c49f29f66c821368e4acb1de16762b04e0174532465"
    modeQuery:
      in: query
      name: mode
      required: true
      description: "mode"
      schema:
        type: integer
        format: int32
        example: 0
    countQuery:
      in: query
      name: count
      required: true
      description: "count"
      schema:
        type: integer
        format: int32
        example: 100
    knownBlockIDExtQuery:
      in: query
      name: known_block
      required: true
      description: "known block: (workchain,shard,seqno,root_hash,file_hash)"
      schema:
        type: string
        example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
    targetBlockIDExtQuery:
      in: query
      name: target_block
      required: false
      description: "target block: (workchain,shard,seqno,root_hash,file_hash)"
      schema:
        type: string
        example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
    ltMustQuery:
      in: query
      name: lt
      required: true
      description: "lt"
      schema:
        type: integer
        format: int64
        example: 23814011000000
    ltQuery:
      in: query
      name: lt
      description: "lt"
      schema:
        type: integer
        format: int64
        example: 23814011000000
    hashQuery:
      in: query
      name: hash
      required: true
      description: "hash"
      schema:
        type: string
        example: "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
    workchainQuery:
      in: query
      name: workchain
      required: true
      description: "workchain"
      schema:
        type: integer
        format: int32
        example: 1
    shardQuery:
      in: query
      name: shard
      required: true
      description: "shard"
      schema:
        type: integer
        format: int64
        example: 1
    exactQuery:
      in: query
      name: exact
      required: true
      description: "exact"
      schema:
        type: boolean
        example: false
    accountIDQuery:
      in: query
      name: account_id
      required: false
      description: account ID
      explode: false
      schema:
        type: string
        format: address
        example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    initiatorQuery:
      in: query
      name: initiator
      description: Show only events that are initiated by this account
      explode: false
      schema:
        type: boolean
        default: false
    currenciesQuery:
      in: query
      name: currencies
      description: accept gram and all possible fiat currencies, separated by commas
      required: false
      explode: false
      schema:
        type: array
        items:
          type: string
        example: [ "gram", "usd", "rub" ]
    supportedExtensions:
      in: query
      name: supported_extensions
      description: "comma separated list supported extensions"
      explode: false
      required: false
      schema:
        type: array
        items:
          type: string
        example: [ "custom_payload", "defi" ]
    currencyQuery:
      in: query
      name: currency
      required: false
      schema:
        type: string
        example: "usd"
    fromQuery:
      in: query
      name: from
      required: true
      schema:
        type: integer
        format: int64
    toQuery:
      in: query
      name: to
      required: true
      schema:
        type: integer
        format: int64

  requestBodies:
    MethodParameters:
      description: input parameters for contract get method
      content:
        application/json:
          schema:
            type: object
    BatchBoc:
      description: both a single boc and a batch of boc serialized in base64/hex are accepted
      required: true
      content:
        application/json:
          schema:
            type: object
            properties:
              boc:
                type: string
                format: cell
              batch:
                type: array
                maxItems: 5
                items:
                  type: string
                  format: cell
              meta:
                type: object
                additionalProperties:
                  type: string
    EmulationBoc:
      description: bag-of-cells serialized to base64/hex and additional parameters to configure emulation
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - boc
            properties:
              boc:
                type: string
                format: cell
              address_override:
                type: string
                format: address
                description: >-
                  Override the destination wallet address extracted from the BoC.
                  Useful when the BoC was signed with a throwaway key and the real
                  wallet address must be emulated against.
                example: "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b"
              params:
                type: array
                description: additional per account configuration
                items:
                  type: object
                  required:
                    - address
                  properties:
                    address:
                      type: string
                      format: address
                      example: "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b"
                    balance:
                      type: integer
                      format: int64
                      example: 10000000000
                      x-js-format: bigint
    InternalMessages:
      description: bag-of-cells serialized to hex
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - messages
              - wallet_address
              - wallet_public_key
            properties:
              throw_error_if_not_enough_jettons:
                type: boolean
                default: false
                description: TONAPI verifies that the account has enough jettons to pay the commission and make a transfer.
              return_emulation:
                type: boolean
                default: false
              wallet_address:
                type: string
                format: address
              wallet_public_key:
                type: string
              messages:
                type: array
                items:
                  type: object
                  required:
                    - boc
                  properties:
                    boc:
                      type: string
                      format: cell
    GaslessSend:
      description: bag-of-cells serialized to hex
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - boc
            properties:
              wallet_public_key:
                type: string
                description: hex encoded public key
              boc:
                type: string
                format: cell
    Boc:
      description: bag-of-cells serialized to hex
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - boc
            properties:
              boc:
                type: string
                format: cell
    AccountIDs:
      description: a list of account ids
      content:
        application/json:
          schema:
            type: object
            required:
              - account_ids
            properties:
              account_ids:
                type: array
                items:
                  type: string
                  format: address
                  example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
    PublicKeys:
      description: a list of hex-encoded ed25519 public keys
      content:
        application/json:
          schema:
            type: object
            required:
              - public_keys
            properties:
              public_keys:
                type: array
                items:
                  type: string
                  example: d8519b83d5b04b17a706ef6d04f3566422be47c2b676b0823235d67b1ef4b1b2
    TonConnectProof:
      description: "Data that is expected from TON Connect"
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - address
              - proof
            properties:
              address:
                type: string
                format: address
                example: "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b"
              proof:
                type: object
                required:
                  - timestamp
                  - domain
                  - signature
                  - payload
                properties:
                  timestamp:
                    type: integer
                    format: int64
                    example: "1678275313"
                  domain:
                    type: object
                    required:
                      - value
                    properties:
                      length_bytes:
                        type: integer
                        format: int32
                      value:
                        type: string
                  signature:
                    type: string
                  payload:
                    type: string
                    example: "84jHVNLQmZsAAAAAZB0Zryi2wqVJI-KaKNXOvCijEi46YyYzkaSHyJrMPBMOkVZa"
                  state_init:
                    type: string
                    format: cell-base64
    TonConnectStateInit:
      description: "Data that is expected"
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - state_init
            properties:
              state_init:
                type: string
                format: cell-base64
    LiteServerSendMessageRequest:
      description: "Data that is expected"
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - body
            properties:
              body:
                type: string
                format: cell-base64
    ExecGetMethodArgs:
      description: >
        Request body for executing a GET method on a blockchain account via POST.
        This format allows passing arguments in the request body instead of query parameters,
        which is especially useful for large or complex input data.
      content:
        application/json:
          schema:
            type: object
            required:
              - args
            properties:
              args:
                type: array
                items:
                  $ref: '#/components/schemas/ExecGetMethodArg'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          example: error description
    AccountAddress:
      type: object
      required:
        - address
        - is_scam
        - is_wallet
      properties:
        address:
          type: string
          format: maybe-address
          example: 0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
        name:
          type: string
          example: Ton foundation
          description: Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        is_scam:
          type: boolean
          example: true
          description: Is this account was marked as part of scammers activity
        icon:
          type: string
          example: https://ton.org/logo.png
        is_wallet:
          type: boolean
          example: true
    BlockCurrencyCollection:
      type: object
      required:
        - grams
        - other
      properties:
        grams:
          type: integer
          format: int64
          example: 10000000000
          x-js-format: bigint
        other:
          type: array
          items:
            type: object
            required:
              - id
              - value
            properties:
              id:
                type: integer
                format: int64
                example: 13
              value:
                type: string
                x-js-format: bigint
                example: "10000000000"
    BlockValueFlow:
      type: object
      required:
        - from_prev_blk
        - to_next_blk
        - imported
        - exported
        - fees_collected
        - fees_imported
        - recovered
        - created
        - minted
      properties:
        from_prev_blk:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        to_next_blk:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        imported:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        exported:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        fees_collected:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        burned:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        fees_imported:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        recovered:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        created:
          $ref: '#/components/schemas/BlockCurrencyCollection'
        minted:
          $ref: '#/components/schemas/BlockCurrencyCollection'
    ServiceStatus:
      type: object
      required:
        - indexing_latency
        - rest_online
        - last_known_masterchain_seqno
      properties:
        rest_online:
          type: boolean
          default: true
        indexing_latency:
          type: integer
          example: 100
        last_known_masterchain_seqno:
          type: integer
          example: 123456
          format: int32
    ReducedBlock:
      type: object
      required:
        - workchain_id
        - shard
        - seqno
        - tx_quantity
        - utime
        - shards_blocks
        - parent
      properties:
        workchain_id:
          type: integer
          example: 0
          format: int32
        shard:
          type: string
          # x-js-format: bigint ???
          example: "8000000000000000"
        seqno:
          type: integer
          example: 21734019
          format: int32
        master_ref:
          type: string
          example: (-1,4234234,8000000000000000)
        tx_quantity:
          type: integer
          example: 130
        utime:
          type: integer
          format: int64
          example: 23814011000000
        shards_blocks:
          type: array
          items:
            type: string
            example: "[ (0,4234235,8000000000000000) ]"
        parent:
          type: array
          items:
            type: string
            example: "[ (0,21734018,8000000000000000) ]"
    BlockchainBlock:
      type: object
      required:
        - workchain_id
        - shard
        - seqno
        - root_hash
        - file_hash
        - global_id
        - value_flow
        - version
        - after_merge
        - before_split
        - after_split
        - want_split
        - want_merge
        - key_block
        - gen_utime
        - start_lt
        - end_lt
        - vert_seqno
        - gen_catchain_seqno
        - min_ref_mc_seqno
        - prev_key_block_seqno
        - prev_refs
        - in_msg_descr_length
        - out_msg_descr_length
        - rand_seed
        - created_by
        - tx_quantity
      properties:
        tx_quantity:
          type: integer
          example: 130
        value_flow:
          $ref: '#/components/schemas/BlockValueFlow'
        workchain_id:
          type: integer
          example: 0
          format: int32
        shard:
          type: string
          # x-js-format: bigint ???
          example: "8000000000000000"
        seqno:
          type: integer
          example: 21734019
          format: int32
        root_hash:
          type: string
          example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        file_hash:
          type: string
          example: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
        global_id:
          type: integer
          example: -239
          format: int32
        version:
          type: integer
          example: 0
          format: int32
        after_merge:
          type: boolean
          example: true
        before_split:
          type: boolean
          example: true
        after_split:
          type: boolean
          example: true
        want_split:
          type: boolean
          example: true
        want_merge:
          type: boolean
          example: true
        key_block:
          type: boolean
          example: true
        gen_utime:
          type: integer
          format: int64
          example: 1674826775
        start_lt:
          type: integer
          format: int64
          example: 23814011000000
          x-js-format: bigint
        end_lt:
          type: integer
          format: int64
          example: 23814011000001
          x-js-format: bigint
        vert_seqno:
          type: integer
          example: 0
          format: int32
        gen_catchain_seqno:
          type: integer
          example: 0
          format: int32
        min_ref_mc_seqno:
          type: integer
          example: 0
          format: int32
        prev_key_block_seqno:
          type: integer
          example: 0
          format: int32
        gen_software_version:
          type: integer
          example: 0
          format: int32
        gen_software_capabilities:
          type: integer
          format: int64
          example: 0
        master_ref:
          type: string
          example: (-1,4234234,8000000000000000)
        prev_refs:
          type: array
          items:
            type: string
            example: [ (-1,4234235,8000000000000000) ]
        in_msg_descr_length:
          type: integer
          format: int64
          example: 0
        out_msg_descr_length:
          type: integer
          format: int64
          example: 0
        rand_seed:
          type: string
          example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        created_by:
          type: string
          example: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
    BlockchainBlocks:
      type: object
      required:
        - blocks
      properties:
        blocks:
          type: array
          items:
            $ref: '#/components/schemas/BlockchainBlock'
    ReducedBlocks:
      type: object
      required:
        - blocks
      properties:
        blocks:
          type: array
          items:
            $ref: '#/components/schemas/ReducedBlock'
    BlockchainBlockShards:
      type: object
      required:
        - shards
      properties:
        shards:
          type: array
          items:
            type: object
            required:
              - last_known_block_id
              - last_known_block
            properties:
              last_known_block_id:
                type: string
                example: (0,8000000000000000,4234234)
              last_known_block:
                $ref: '#/components/schemas/BlockchainBlock'
    AccountStatus:
      type: string
      example: active
      enum:
        - nonexist
        - uninit
        - active
        - frozen
    StateInit:
      type: object
      required:
        - boc
        - interfaces
      properties:
        boc:
          type: string
          format: cell
          example: b5ee9c72010106010044000114ff00f4a413f4bcf2c80b01020120020302014804050004f2300038d06c21d31f30ed44d0d33f3001c00197a4c8cb3fc9ed549330f206e20011a13431da89a1a67e61
        interfaces:
          type: array
          items:
            type: string
    Message:
      type: object
      required:
        - msg_type
        - created_lt
        - ihr_disabled
        - bounce
        - bounced
        - value
        - fwd_fee
        - ihr_fee
        - import_fee
        - created_at
        - hash
      properties:
        msg_type:
          type: string
          example: int_msg
          enum:
            - int_msg
            - ext_in_msg
            - ext_out_msg
        created_lt:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
        ihr_disabled:
          type: boolean
          example: true
        bounce:
          type: boolean
          example: true
        bounced:
          type: boolean
          example: true
        value:
          type: integer
          format: int64
          x-js-format: bigint
          example: 60000000
        value_extra:
          type: array
          items:
            $ref: '#/components/schemas/ExtraCurrency'
        fwd_fee:
          type: integer
          format: int64
          x-js-format: bigint
          example: 5681002
        ihr_fee:
          type: integer
          format: int64
          x-js-format: bigint
          example: 5681002
        destination:
          $ref: '#/components/schemas/AccountAddress'
        source:
          $ref: '#/components/schemas/AccountAddress'
        import_fee:
          type: integer
          format: int64
          x-js-format: bigint
          example: 5681002
        created_at:
          type: integer
          format: int64
          example: 5681002
        op_code:
          type: string
          x-js-format: bigint
          example: "0xdeadbeaf"
        init:
          $ref: '#/components/schemas/StateInit'
        hash:
          type: string
          example: "1219de582369ac80ee1afe12147930f458a54ff1eea612611a8bc6bd31581a6c"
        raw_body:
          type: string
          format: cell
          description: hex-encoded BoC with raw message body
          example: "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218"
        decoded_op_name:
          type: string
          example: "nft_transfer"
        decoded_body: { } # Free-form JSON value
    TransactionType:
      type: string
      example: TransOrd
      enum:
        - TransOrd
        - TransTickTock
        - TransSplitPrepare
        - TransSplitInstall
        - TransMergePrepare
        - TransMergeInstall
        - TransStorage
    AccStatusChange:
      type: string
      example: acst_unchanged
      enum:
        - acst_unchanged
        - acst_frozen
        - acst_deleted
    ComputeSkipReason:
      type: string
      example: cskip_no_state
      enum:
        - cskip_no_state
        - cskip_bad_state
        - cskip_no_gas
        - cskip_suspended
    BouncePhaseType:
      type: string
      example: cskip_no_state
      enum:
        - TrPhaseBounceNegfunds
        - TrPhaseBounceNofunds
        - TrPhaseBounceOk
    ComputePhase:
      type: object
      required:
        - skipped
      properties:
        skipped:
          type: boolean
          example: true
        skip_reason:
          $ref: '#/components/schemas/ComputeSkipReason'
        success:
          type: boolean
          example: true
        gas_fees:
          type: integer
          format: int64
          x-js-format: bigint
          example: 1000
        gas_used:
          type: integer
          format: int64
          x-js-format: bigint
          example: 10000
        vm_steps:
          type: integer
          format: int32
          example: 5
        exit_code:
          type: integer
          format: int32
          example: 0
        exit_code_description:
          type: string
    StoragePhase:
      type: object
      required:
        - fees_collected
        - status_change
      properties:
        fees_collected:
          type: integer
          format: int64
          x-js-format: bigint
          example: 25713146000001
        fees_due:
          type: integer
          format: int64
          x-js-format: bigint
          example: 25713146000001
        status_change:
          $ref: '#/components/schemas/AccStatusChange'
    CreditPhase:
      type: object
      required:
        - fees_collected
        - credit
      properties:
        fees_collected:
          type: integer
          format: int64
          x-js-format: bigint
          example: 100
        credit:
          type: integer
          format: int64
          x-js-format: bigint
          example: 1000
    ActionPhase:
      type: object
      required:
        - success
        - result_code
        - total_actions
        - skipped_actions
        - fwd_fees
        - total_fees
      properties:
        success:
          type: boolean
          example: true
        result_code:
          type: integer
          format: int32
          example: 5
        total_actions:
          type: integer
          format: int32
          example: 5
        skipped_actions:
          type: integer
          format: int32
          example: 5
        fwd_fees:
          type: integer
          format: int64
          x-js-format: bigint
          example: 1000
        total_fees:
          type: integer
          format: int64
          x-js-format: bigint
          example: 1000
        result_code_description:
          type: string
    Transaction:
      type: object
      required:
        - hash
        - lt
        - account
        - end_balance
        - success
        - utime
        - orig_status
        - end_status
        - total_fees
        - transaction_type
        - state_update_old
        - state_update_new
        - out_msgs
        - block
        - aborted
        - destroyed
        - raw
      properties:
        hash:
          type: string
          example: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
        lt:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
        account:
          $ref: '#/components/schemas/AccountAddress'
        success:
          type: boolean
          example: true
        utime:
          type: integer
          format: int64
          example: 1645544908
        orig_status:
          $ref: '#/components/schemas/AccountStatus'
        end_status:
          $ref: '#/components/schemas/AccountStatus'
        total_fees:
          type: integer
          format: int64
          x-js-format: bigint
          example: 25713146000001
        end_balance:
          type: integer
          format: int64
          x-js-format: bigint
          example: 25713146000001
        transaction_type:
          $ref: '#/components/schemas/TransactionType'
        state_update_old:
          type: string
          example: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
        state_update_new:
          type: string
          example: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
        in_msg:
          $ref: '#/components/schemas/Message'
        out_msgs:
          type: array
          items:
            $ref: '#/components/schemas/Message'
        block:
          type: string
          example: (-1,4234234,8000000000000000)
        prev_trans_hash:
          type: string
          example: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
        prev_trans_lt:
          type: integer
          format: int64
          x-js-format: bigint
          example: 25713146000001
        compute_phase:
          $ref: '#/components/schemas/ComputePhase'
        storage_phase:
          $ref: '#/components/schemas/StoragePhase'
        credit_phase:
          $ref: '#/components/schemas/CreditPhase'
        action_phase:
          $ref: '#/components/schemas/ActionPhase'
        bounce_phase:
          $ref: '#/components/schemas/BouncePhaseType'
        aborted:
          type: boolean
          example: true
        destroyed:
          type: boolean
          example: true
        raw:
          type: string
          format: cell
          description: "hex encoded boc with raw transaction"
          example: "b5ee9c72410206010001380003b372cf3b5b8c891e517c9addbda1c0386a09ccacbb0e3faf630b51cfc8152325acb00002ac5795c0e41fdf79135cb7da03cc623b165d614b562a51eeccd8a5e097f405abf6b37f4e73000002ac5629732c1666887ed000144030480102030101a004008272abc8f2971aa4404ac6da1597720f348b2e1247b1ad9f55cbd3b6812f0a5f08b269bb65039fb1f6074d00f794e857f6dfd01131d299df456af10a8a4943d4d165000d0c80608840492001ab48015581f575c3b8c6ab3d6"
    Transactions:
      type: object
      required:
        - transactions
      properties:
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/Transaction'
    ConfigProposalSetup:
      type: object
      required:
        - min_tot_rounds
        - max_tot_rounds
        - min_wins
        - max_losses
        - min_store_sec
        - max_store_sec
        - bit_price
        - cell_price
      properties:
        min_tot_rounds:
          type: integer
          example: 2
        max_tot_rounds:
          type: integer
          example: 6
        min_wins:
          type: integer
          example: 2
        max_losses:
          type: integer
          example: 6
        min_store_sec:
          type: integer
          format: int64
          example: 1000000
        max_store_sec:
          type: integer
          format: int64
          example: 10000000
        bit_price:
          type: integer
          format: int64
          example: 1
        cell_price:
          type: integer
          format: int64
          example: 500
    GasLimitPrices:
      type: object
      required:
        - gas_price
        - gas_limit
        - gas_credit
        - block_gas_limit
        - freeze_due_limit
        - delete_due_limit
      properties:
        special_gas_limit:
          type: integer
          format: int64
        flat_gas_limit:
          type: integer
          format: int64
        flat_gas_price:
          type: integer
          format: int64
        gas_price:
          type: integer
          format: int64
          example: 1
        gas_limit:
          type: integer
          format: int64
          example: 1000000
        gas_credit:
          type: integer
          format: int64
          example: 1000000
        block_gas_limit:
          type: integer
          format: int64
          example: 1000000
        freeze_due_limit:
          type: integer
          format: int64
          example: 1000000
        delete_due_limit:
          type: integer
          format: int64
          example: 1000000
    BlockParamLimits:
      type: object
      required:
        - underload
        - soft_limit
        - hard_limit
      properties:
        underload:
          type: integer
          format: int64
          example: 1000000
        soft_limit:
          type: integer
          format: int64
          example: 1000000
        hard_limit:
          type: integer
          format: int64
          example: 1000000
    BlockLimits:
      type: object
      required:
        - bytes
        - gas
        - lt_delta
      properties:
        bytes:
          $ref: '#/components/schemas/BlockParamLimits'
        gas:
          $ref: '#/components/schemas/BlockParamLimits'
        lt_delta:
          $ref: '#/components/schemas/BlockParamLimits'
    MsgForwardPrices:
      type: object
      required:
        - lump_price
        - bit_price
        - cell_price
        - ihr_price_factor
        - first_frac
        - next_frac
      properties:
        lump_price:
          type: integer
          format: int64
          example: 1000000
        bit_price:
          type: integer
          format: int64
          example: 1000000
        cell_price:
          type: integer
          format: int64
          example: 1000000
        ihr_price_factor:
          type: integer
          format: int64
          example: 1000000
        first_frac:
          type: integer
          format: int64
          example: 1000000
        next_frac:
          type: integer
          format: int64
          example: 1000000
    WorkchainDescr:
      type: object
      required:
        - workchain
        - enabled_since
        - actual_min_split
        - min_split
        - max_split
        - basic
        - active
        - accept_msgs
        - flags
        - zerostate_root_hash
        - zerostate_file_hash
        - version
      properties:
        workchain:
          type: integer
          format: int
          example: 0
        enabled_since:
          type: integer
          format: int64
          example: 1000000
        actual_min_split:
          type: integer
          format: int
          example: 1000000
        min_split:
          type: integer
          format: int
          example: 1000000
        max_split:
          type: integer
          format: int
          example: 1000000
        basic:
          type: integer
          example: 1000000
        active:
          type: boolean
          example: true
        accept_msgs:
          type: boolean
          example: true
        flags:
          type: integer
          format: int
          example: 1000000
        zerostate_root_hash:
          type: string
          example: "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
        zerostate_file_hash:
          type: string
          example: "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
        version:
          type: integer
          format: int64
          example: 1000000
    MisbehaviourPunishmentConfig:
      type: object
      required:
        - default_flat_fine
        - default_proportional_fine
        - severity_flat_mult
        - severity_proportional_mult
        - unpunishable_interval
        - long_interval
        - long_flat_mult
        - long_proportional_mult
        - medium_interval
        - medium_flat_mult
        - medium_proportional_mult
      properties:
        default_flat_fine:
          type: integer
          format: int64
          example: 1000000
        default_proportional_fine:
          type: integer
          format: int64
          example: 1000000
        severity_flat_mult:
          type: integer
          example: 1000000
        severity_proportional_mult:
          type: integer
          example: 1000000
        unpunishable_interval:
          type: integer
          example: 1000000
        long_interval:
          type: integer
          example: 1000000
        long_flat_mult:
          type: integer
          example: 1000000
        long_proportional_mult:
          type: integer
          example: 1000000
        medium_interval:
          type: integer
          example: 1000000
        medium_flat_mult:
          type: integer
          example: 1000000
        medium_proportional_mult:
          type: integer
          example: 1000000

    SizeLimitsConfig:
      type: object
      required:
        - max_msg_bits
        - max_msg_cells
        - max_library_cells
        - max_vm_data_depth
        - max_ext_msg_size
        - max_ext_msg_depth
      properties:
        max_msg_bits:
          type: integer
          format: int64
          example: 1000000
        max_msg_cells:
          type: integer
          format: int64
          example: 1000000
        max_library_cells:
          type: integer
          format: int64
          example: 1000000
        max_vm_data_depth:
          type: integer
          format: int
          example: 1000000
        max_ext_msg_size:
          type: integer
          format: int64
          example: 1000000
        max_ext_msg_depth:
          type: integer
          format: int
          example: 1000000
        max_acc_state_cells:
          type: integer
          format: int64
          example: 1000000
        max_acc_state_bits:
          type: integer
          format: int64
          example: 1000000
    NewConsensusConfig:
      type: object
      required:
        - flags
        - use_quic
        - slots_per_leader_window
      properties:
        flags:
          type: integer
          format: int
          example: 0
          x-js-format: bigint
        use_quic:
          type: boolean
          example: false
        target_rate_ms:
          type: integer
          format: int64
          example: 1000
          x-js-format: bigint
        slots_per_leader_window:
          type: integer
          format: int64
          example: 1
          x-js-format: bigint
        first_block_timeout_ms:
          type: integer
          format: int64
          example: 1000
          x-js-format: bigint
        max_leader_window_desync:
          type: integer
          format: int64
          example: 4
          x-js-format: bigint
        noncritical_params:
          type: object
          additionalProperties:
            type: integer
            format: int64
            x-js-format: bigint
    ValidatorsSet:
      type: object
      required:
        - utime_since
        - utime_until
        - total
        - main
        - list
      properties:
        utime_since:
          type: integer
        utime_until:
          type: integer
        total:
          type: integer
        main:
          type: integer
        total_weight:
          type: string
          x-js-format: bigint
          example: "1152921504606846800"
        list:
          type: array
          items:
            type: object
            required:
              - public_key
              - weight
            properties:
              public_key:
                type: string
              weight:
                type: integer
                format: int64
                x-js-format: bigint
              adnl_addr:
                type: string
                example: "45061C1D4EC44A937D0318589E13C73D151D1CEF5D3C0E53AFBCF56A6C2FE2BD"
    Oracle:
      type: object
      required:
        - address
        - secp_pubkey
      properties:
        address:
          type: string
          format: address
          example: 0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
        secp_pubkey:
          type: string
          example: 00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6
    OracleBridgeParams:
      type: object
      required:
        - bridge_addr
        - oracle_multisig_address
        - external_chain_address
        - oracles
      properties:
        bridge_addr:
          type: string
          format: address
        oracle_multisig_address:
          type: string
          format: address
        external_chain_address:
          type: string
        oracles:
          type: array
          items:
            $ref: '#/components/schemas/Oracle'
    JettonBridgePrices:
      type: object
      required:
        - bridge_burn_fee
        - bridge_mint_fee
        - wallet_min_gram_for_storage
        - wallet_gas_consumption
        - minter_min_gram_for_storage
        - discover_gas_consumption
      properties:
        bridge_burn_fee:
          type: integer
          format: int64
        bridge_mint_fee:
          type: integer
          format: int64
        wallet_min_tons_for_storage:
          type: integer
          format: int64
          deprecated: true
          description: this field will gone after Sept. 2026, use wallet_min_gram_for_storage instead
        wallet_min_gram_for_storage:
          type: integer
          format: int64
        wallet_gas_consumption:
          type: integer
          format: int64
        minter_min_tons_for_storage:
          type: integer
          format: int64
          deprecated: true
          description: this field will gone after Sept. 2026, use wallet_min_gram_for_storage instead
        minter_min_gram_for_storage:
          type: integer
          format: int64
        discover_gas_consumption:
          type: integer
          format: int64
    JettonBridgeParams:
      type: object
      required:
        - bridge_address
        - oracles_address
        - state_flags
        - oracles
      properties:
        bridge_address:
          type: string
          format: address
        oracles_address:
          type: string
          format: address
        state_flags:
          type: integer
        burn_bridge_fee:
          type: integer
          format: int64
        oracles:
          type: array
          items:
            $ref: '#/components/schemas/Oracle'
        external_chain_address:
          type: string
        prices:
          $ref: '#/components/schemas/JettonBridgePrices'
    Validator:
      type: object
      required:
        - address
        - adnl_address
        - stake
        - max_factor
      properties:
        address:
          type: string
          format: address
          example: 0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
        adnl_address:
          type: string
          example: 10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
        stake:
          type: integer
          format: int64
          example: 123456789
          x-js-format: bigint
        max_factor:
          type: integer
          format: int64
          example: 123456789
    Validators:
      type: object
      required:
        - validators
        - elect_at
        - elect_close
        - min_stake
        - total_stake
      properties:
        elect_at:
          type: integer
          format: int64
          example: 123456789
        elect_close:
          type: integer
          format: int64
          example: 123456789
        min_stake:
          type: integer
          format: int64
          x-js-format: bigint
          example: 123456789
        total_stake:
          type: integer
          format: int64
          x-js-format: bigint
          example: 123456789
        validators:
          type: array
          items:
            $ref: '#/components/schemas/Validator'
    AccountStorageInfo:
      type: object
      required:
        - used_cells
        - used_bits
        - used_public_cells
        - last_paid
        - due_payment
      properties:
        used_cells:
          type: integer
          format: int64
          example: 567
        used_bits:
          type: integer
          format: int64
          example: 567
        used_public_cells:
          type: integer
          format: int64
          example: 567
        last_paid:
          type: integer
          format: int64
          description: time of the last payment
          example: 1720860269
        due_payment:
          type: integer
          format: int64
          x-js-format: bigint
          example: 567
    BlockchainRawAccount:
      type: object
      required:
        - address
        - balance
        - status
        - last_transaction_lt
        - storage
      properties:
        address:
          type: string
          format: address
          example: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
        balance:
          type: integer
          format: int64
          x-js-format: bigint
          example: 123456789
        extra_balance:
          type: array
          items:
            $ref: '#/components/schemas/ExtraCurrency'
        code:
          type: string
          format: cell
          example: b5ee9c72410104010087000114ff00f4a413f4a0f2c80b0102012002030002d200dfa5ffff76a268698fe9ffe8e42c5267858f90e785ffe4f6aa6467c444ffb365ffc10802faf0807d014035e7a064b87d804077e7857fc10803dfd2407d014035e7a064b86467cd8903a32b9ba4410803ade68afd014035e7a045ea432b6363796103bb7b9363210c678b64b87d807d8040c249b3e4
        data:
          type: string
          format: cell
          example: b5ee9c7241010101002600004811fd096c0000000000000000000000000000000000000000000000000000000000000000cb78264d
        last_transaction_lt:
          type: integer
          format: int64
          x-js-format: bigint
          example: 123456789
        last_transaction_hash:
          type: string
          example: 088b436a846d92281734236967970612f87fbd64a2cd3573107948379e8e4161
        frozen_hash:
          type: string
          example: 088b436a846d92281734236967970612f87fbd64a2cd3573107948379e8e4161
        status:
          '$ref': '#/components/schemas/AccountStatus'
        storage:
          $ref: '#/components/schemas/AccountStorageInfo'
        libraries:
          type: array
          items:
            type: object
            required:
              - public
              - root
            properties:
              public:
                type: boolean
                example: true
              root:
                type: string
                format: cell
    BlockchainRawAccounts:
      type: object
      required:
        - accounts
      properties:
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/BlockchainRawAccount'
    BlockchainLibrary:
      type: object
      required:
        - boc
      properties:
        boc:
          type: string
          format: cell
          example: b5ee9c7201010101005f0000baff0020dd2082014c97ba218201339cbab19c71b0ed44d0d31fd70bffe304e0a4f260810200d71820d70b1fed44d0d31fd3ffd15112baf2a122f901541044f910f2a2f80001d31f3120d74a96d307d402fb00ded1a4c8cb1fcbffc9ed54
    WalletStats:
      type: object
      required:
        - nfts_count
        - jettons_count
        - multisig_count
        - staking_count
      properties:
        nfts_count:
          type: integer
          format: int32
          example: 123456789
        jettons_count:
          type: integer
          format: int32
          example: 123456789
        multisig_count:
          type: integer
          format: int32
          example: 123456789
        staking_count:
          type: integer
          format: int32
          example: 123456789
    WalletPlugin:
      type: object
      required:
        - address
        - type
        - status
      properties:
        address:
          type: string
          format: address
          example: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
        type:
          type: string
          example: "subscription_v1"
        status:
          '$ref': '#/components/schemas/AccountStatus'
    Wallets:
      type: object
      required:
        - accounts
      properties:
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/Wallet'
    WalletsByPublicKeys:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          description: Wallets grouped by the originating public key
          items:
            $ref: '#/components/schemas/WalletsByPublicKey'
    WalletsByPublicKey:
      type: object
      required:
        - public_key
        - wallets
      properties:
        public_key:
          type: string
          description: hex-encoded ed25519 public key
          example: d8519b83d5b04b17a706ef6d04f3566422be47c2b676b0823235d67b1ef4b1b2
        wallets:
          type: array
          items:
            $ref: '#/components/schemas/Wallet'
    Wallet:
      type: object
      required:
        - address
        - balance
        - stats
        - plugins
        - status
        - last_activity
        - get_methods
        - is_wallet
        - last_lt
      properties:
        address:
          type: string
          format: address
          example: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
        is_wallet:
          type: boolean
        balance:
          type: integer
          format: int64
          example: 123456789
          x-js-format: bigint
        stats:
          $ref: '#/components/schemas/WalletStats'
        plugins:
          type: array
          items:
            $ref: '#/components/schemas/WalletPlugin'
        status:
          '$ref': '#/components/schemas/AccountStatus'
        last_activity:
          type: integer
          description: unix timestamp
          format: int64
          example: 1720860269
        name:
          type: string
          example: "Ton foundation"
        icon:
          type: string
          example: "https://ton.org/logo.png"
        get_methods:
          type: array
          deprecated: true
          items:
            type: string
          example: [ 'get_item_data' ]
        is_suspended:
          type: boolean
        signature_disabled:
          type: boolean
        interfaces:
          type: array
          items:
            type: string
        last_lt:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
    Account:
      type: object
      required:
        - address
        - balance
        - status
        - last_activity
        - get_methods
        - is_wallet
      properties:
        address:
          type: string
          format: address
          example: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
        balance:
          type: integer
          format: int64
          example: 123456789
          x-js-format: bigint
        extra_balance:
          type: array
          items:
            $ref: '#/components/schemas/ExtraCurrency'
        currencies_balance:
          description: "{'USD': 1, 'IDR': 1000}"
          type: object
          additionalProperties: true
          example: { }
        last_activity:
          type: integer
          description: unix timestamp
          format: int64
          example: 1720860269
        status:
          '$ref': '#/components/schemas/AccountStatus'
        interfaces:
          type: array
          items:
            type: string
            example: nft_sale
        name:
          type: string
          example: "Ton foundation"
        is_scam:
          type: boolean
          example: true
        icon:
          type: string
          example: "https://ton.org/logo.png"
        memo_required:
          type: boolean
          example: true
        get_methods:
          type: array
          items:
            type: string
          example: [ 'get_item_data' ]
        is_suspended:
          type: boolean
        is_wallet:
          type: boolean
    Accounts:
      type: object
      required:
        - accounts
      properties:
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/Account'
    GaslessConfig:
      type: object
      required:
        - gas_jettons
        - relay_address
      properties:
        relay_address:
          type: string
          format: address
          description: "sending excess to this address decreases the commission of a gasless transfer"
          example: 0:dfbd5be8497fdc0c9fcbdfc676864840ddf8ad6423d6d5657d9b0e8270d6c8ac
        gas_jettons:
          type: array
          description: "list of jettons, any of them can be used to pay for gas"
          items:
            type: object
            required:
              - master_id
            properties:
              master_id:
                type: string
                format: address
    SignRawMessage:
      type: object
      required:
        - address
        - amount
      properties:
        address:
          type: string
          format: address
          example: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
        amount:
          type: string
          # x-js-format: bigint
          # example: "1000000" nanocoins or decimal ?
          description: "Number of nanocoins to send. Decimal string."
        payload:
          type: string
          format: cell
          description: "Raw one-cell BoC encoded in hex."
        stateInit:
          type: string
          format: cell
          description: "Raw once-cell BoC encoded in hex."
    GaslessTx:
      type: object
      required:
        - protocol_name
      properties:
        protocol_name:
          type: string
        external:
          type: string
          description: "Normalized hash of the external message."
    SignRawParams:
      type: object
      required:
        - messages
        - relay_address
        - commission
        - from
        - valid_until
        - protocol_name
      properties:
        protocol_name:
          type: string
        relay_address:
          type: string
          format: address
          example: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
        commission:
          type: string
          x-js-format: bigint
          example: "1000000"
          description: "Commission for the transaction. In nanocoins."
        from:
          type: string
          format: address
          example: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
        valid_until:
          type: integer
          format: int64
          example: 1717397217
        messages:
          type: array
          items:
            $ref: '#/components/schemas/SignRawMessage'
        emulation:
          $ref: '#/components/schemas/MessageConsequences'
    MethodExecutionResult:
      type: object
      required:
        - success
        - exit_code
        - stack
      properties:
        success:
          type: boolean
          example: true
        exit_code:
          type: integer
          example: 0
          description: tvm exit code
        stack:
          type: array
          items:
            $ref: "#/components/schemas/TvmStackRecord"
        decoded: { } # Free-form JSON value
    TvmStackRecord:
      type: object
      format: tuple-item
      required:
        - type
      properties:
        type:
          type: string
          example: "cell"
          enum:
            - cell
            - num
            - nan
            - "null"
            - tuple
        cell:
          type: string
          format: cell
        slice:
          type: string
          format: cell
        num:
          type: string
          example: ""
        tuple:
          type: array
          example: [ ]
          items:
            $ref: '#/components/schemas/TvmStackRecord'
    RawBlockchainConfig:
      type: object
      required:
        - config
      properties:
        config:
          type: object
          additionalProperties: true
          example: { }

    BlockchainConfig:
      type: object
      required:
        - raw
        - "0"
        - "1"
        - "2"
        - "4"
        - "44"
      properties:
        raw:
          type: string
          format: cell
          description: config boc in hex format
        "0":
          type: string
          format: address
          description: "config address"
        "1":
          type: string
          format: address
          description: "elector address"
        "2":
          type: string
          format: address
          description: "minter address"
        "3":
          type: string
          format: address
          description: "The address of the transaction fee collector."
        "4":
          type: string
          format: address
          description: "dns root address"
        "5":
          type: object
          required:
            - fee_burn_nom
            - fee_burn_denom
          properties:
            blackhole_addr:
              type: string
              format: address
            fee_burn_nom:
              type: integer
              format: int64
            fee_burn_denom:
              type: integer
              format: int64
        "6":
          type: object
          description: Minting fees of new currencies.
          required:
            - mint_new_price
            - mint_add_price
          properties:
            mint_new_price:
              type: integer
              format: int64
            mint_add_price:
              type: integer
              format: int64
        "7":
          type: object
          description: The volume of each of the additional currencies in circulation.
          required:
            - currencies
          properties:
            currencies:
              type: array
              items:
                type: object
                required:
                  - currency_id
                  - amount
                properties:
                  currency_id:
                    type: integer
                    format: int64
                  amount:
                    type: string
                    # x-js-format: bigint
                    # example: "1000000"
        "8":
          type: object
          description: The network version and additional capabilities supported by the validators.
          required:
            - version
            - capabilities
          properties:
            version:
              type: integer
              format: int64
            capabilities:
              type: integer
              format: int64
        "9":
          type: object
          description: List of mandatory parameters of the blockchain config.
          required:
            - mandatory_params
          properties:
            mandatory_params:
              type: array
              items:
                type: integer
                format: int32
        "10":
          type: object
          description: List of critical TON parameters, the change of which significantly affects the network, so more voting rounds are held.
          required:
            - critical_params
          properties:
            critical_params:
              type: array
              items:
                type: integer
                format: int32
        "11":
          type: object
          description: This parameter indicates under what conditions proposals to change the TON configuration are accepted.
          required:
            - normal_params
            - critical_params
          properties:
            normal_params:
              $ref: '#/components/schemas/ConfigProposalSetup'
            critical_params:
              $ref: '#/components/schemas/ConfigProposalSetup'
        "12":
          type: object
          description: Workchains in the TON Blockchain
          required:
            - workchains
          properties:
            workchains:
              type: array
              items:
                $ref: '#/components/schemas/WorkchainDescr'
        "13":
          type: object
          description: The cost of filing complaints about incorrect operation of validators.
          required:
            - deposit
            - bit_price
            - cell_price
          properties:
            deposit:
              type: integer
              format: int64
            bit_price:
              type: integer
              format: int64
            cell_price:
              type: integer
              format: int64
        "14":
          type: object
          description: The reward in nanoGram for block creation in the TON blockchain.
          required:
            - masterchain_block_fee
            - basechain_block_fee
          properties:
            masterchain_block_fee:
              type: integer
              format: int64
            basechain_block_fee:
              type: integer
              format: int64
        "15":
          type: object
          description: The reward in nanograms for block creation in the TON blockchain.
          required:
            - validators_elected_for
            - elections_start_before
            - elections_end_before
            - stake_held_for
          properties:
            validators_elected_for:
              type: integer
              format: int64
              example: 65536
            elections_start_before:
              type: integer
              format: int64
              example: 32768
            elections_end_before:
              type: integer
              format: int64
              example: 8192
            stake_held_for:
              type: integer
              format: int64
              example: 32768
        "16":
          type: object
          description: The limits on the number of validators in the TON blockchain.
          required:
            - max_validators
            - max_main_validators
            - min_validators
          properties:
            max_validators:
              type: integer
              example: 400
            max_main_validators:
              type: integer
              example: 100
            min_validators:
              type: integer
              example: 75
        "17":
          type: object
          description: The stake parameters configuration in the TON blockchain.
          required:
            - min_stake
            - max_stake
            - min_total_stake
            - max_stake_factor
          properties:
            min_stake:
              type: string
              # x-js-format: bigint
              # example: "1000000"
            max_stake:
              type: string
              # x-js-format: bigint
              # example: "1000000"
            min_total_stake:
              type: string
              # x-js-format: bigint
              # example: "1000000"
            max_stake_factor:
              type: integer
              format: int64
        "18":
          type: object
          description: The prices for data storage.
          required:
            - storage_prices
          properties:
            storage_prices:
              type: array
              items:
                type: object
                required:
                  - utime_since
                  - bit_price_ps
                  - cell_price_ps
                  - mc_bit_price_ps
                  - mc_cell_price_ps
                properties:
                  utime_since:
                    type: integer
                    format: int64
                    example: 0
                  bit_price_ps:
                    type: integer
                    format: int64
                    example: 1
                  cell_price_ps:
                    type: integer
                    format: int64
                    example: 500
                  mc_bit_price_ps:
                    type: integer
                    format: int64
                    example: 1000
                  mc_cell_price_ps:
                    type: integer
                    format: int64
                    example: 500000
        "20":
          type: object
          description: The cost of computations in the masterchain. The complexity of any computation is estimated in gas units.
          required:
            - gas_limits_prices
          properties:
            gas_limits_prices:
              $ref: '#/components/schemas/GasLimitPrices'
        "21":
          type: object
          description: The cost of computations in the basechains. The complexity of any computation is estimated in gas units.
          required:
            - gas_limits_prices
          properties:
            gas_limits_prices:
              $ref: '#/components/schemas/GasLimitPrices'
        "22":
          type: object
          description: The limits on the block in the masterchain, upon reaching which the block is finalized and the callback of the remaining messages (if any) is carried over to the next block.
          required:
            - block_limits
          properties:
            block_limits:
              $ref: '#/components/schemas/BlockLimits'
        "23":
          type: object
          description: The limits on the block in the basechains, upon reaching which the block is finalized and the callback of the remaining messages (if any) is carried over to the next block.
          required:
            - block_limits
          properties:
            block_limits:
              $ref: '#/components/schemas/BlockLimits'
        "24":
          type: object
          description: The cost of sending messages in the masterchain of the TON blockchain.
          required:
            - msg_forward_prices
          properties:
            msg_forward_prices:
              $ref: '#/components/schemas/MsgForwardPrices'
        "25":
          type: object
          description: The cost of sending messages in the basechains of the TON blockchain.
          required:
            - msg_forward_prices
          properties:
            msg_forward_prices:
              $ref: '#/components/schemas/MsgForwardPrices'
        "28":
          type: object
          description: The configuration for the Catchain protocol.
          required:
            - mc_catchain_lifetime
            - shard_catchain_lifetime
            - shard_validators_lifetime
            - shard_validators_num
          properties:
            mc_catchain_lifetime:
              type: integer
              format: int64
              example: 1000000
            shard_catchain_lifetime:
              type: integer
              format: int64
              example: 1000000
            shard_validators_lifetime:
              type: integer
              format: int64
              example: 1000000
            shard_validators_num:
              type: integer
              format: int64
              example: 1000000
            flags:
              type: integer
              format: int
              example: 1000000
            shuffle_mc_validators:
              type: boolean
        "29":
          type: object
          description: The configuration for the consensus protocol above catchain.
          required:
            - round_candidates
            - next_candidate_delay_ms
            - consensus_timeout_ms
            - fast_attempts
            - attempt_duration
            - catchain_max_deps
            - max_block_bytes
            - max_collated_bytes
          properties:
            flags:
              type: integer
              format: int
              example: 0
            new_catchain_ids:
              type: boolean
              example: true
            round_candidates:
              type: integer
              format: int64
              example: 3
            next_candidate_delay_ms:
              type: integer
              format: int64
              example: 2000
            consensus_timeout_ms:
              type: integer
              format: int64
              example: 16000
            fast_attempts:
              type: integer
              format: int64
              example: 3
            attempt_duration:
              type: integer
              format: int64
              example: 8
            catchain_max_deps:
              type: integer
              format: int64
              example: 4
            max_block_bytes:
              type: integer
              format: int64
              example: 2097152
            max_collated_bytes:
              type: integer
              format: int64
              example: 2097152
            proto_version:
              type: integer
              format: int64
              example: 2
            catchain_max_blocks_coeff:
              type: integer
              format: int64
              example: 10000
        "30":
          type: object
          description: The configuration for the new consensus protocol. Each chain can have its own optional configuration.
          properties:
            mc:
              $ref: '#/components/schemas/NewConsensusConfig'
            shard:
              $ref: '#/components/schemas/NewConsensusConfig'
        "31":
          type: object
          description: The configuration for the consensus protocol above catchain.
          required:
            - fundamental_smc_addr
          properties:
            fundamental_smc_addr:
              type: array
              items:
                type: string
                format: address
                example: -1:dd24c4a1f2b88f8b7053513b5cc6c5a31bc44b2a72dcb4d8c0338af0f0d37ec5
        "32":
          $ref: '#/components/schemas/ValidatorsSet'
        "33":
          $ref: '#/components/schemas/ValidatorsSet'
        "34":
          $ref: '#/components/schemas/ValidatorsSet'
        "35":
          $ref: '#/components/schemas/ValidatorsSet'
        "36":
          $ref: '#/components/schemas/ValidatorsSet'
        "37":
          $ref: '#/components/schemas/ValidatorsSet'
        "40":
          type: object
          description: The configuration for punishment for improper behavior (non-validation). In the absence of the parameter, the default fine size is 101 Gram
          required:
            - misbehaviour_punishment_config
          properties:
            misbehaviour_punishment_config:
              $ref: '#/components/schemas/MisbehaviourPunishmentConfig'
        "43":
          type: object
          description: The size limits and some other characteristics of accounts and messages.
          required:
            - size_limits_config
          properties:
            size_limits_config:
              $ref: '#/components/schemas/SizeLimitsConfig'
        "44":
          type: object
          description: suspended accounts
          required:
            - accounts
            - suspended_until
          properties:
            accounts:
              type: array
              items:
                type: string
                format: address
                example: 0:0000000000000000000000000000000000000000000000000000000000000000
            suspended_until:
              type: integer

        "45":
          type: object
          description: precompiled contracts
          required:
            - contracts
          properties:
            contracts:
              type: array
              items:
                type: object
                required:
                  - code_hash
                  - gas_usage
                properties:
                  code_hash:
                    type: string
                  gas_usage:
                    type: integer
                    format: int64
        "71":
          type: object
          description: Bridge parameters for wrapping TON in other networks.
          required:
            - oracle_bridge_params
          properties:
            oracle_bridge_params:
              $ref: '#/components/schemas/OracleBridgeParams'
        "72":
          type: object
          description: Bridge parameters for wrapping TON in other networks.
          required:
            - oracle_bridge_params
          properties:
            oracle_bridge_params:
              $ref: '#/components/schemas/OracleBridgeParams'
        "73":
          type: object
          description: Bridge parameters for wrapping TON in other networks.
          required:
            - oracle_bridge_params
          properties:
            oracle_bridge_params:
              $ref: '#/components/schemas/OracleBridgeParams'
        "79":
          type: object
          description: Bridge parameters for wrapping tokens from other networks into tokens on the TON network.
          required:
            - jetton_bridge_params
          properties:
            jetton_bridge_params:
              $ref: '#/components/schemas/JettonBridgeParams'
        "81":
          type: object
          description: Bridge parameters for wrapping tokens from other networks into tokens on the TON network.
          required:
            - jetton_bridge_params
          properties:
            jetton_bridge_params:
              $ref: '#/components/schemas/JettonBridgeParams'
        "82":
          type: object
          description: Bridge parameters for wrapping tokens from other networks into tokens on the TON network.
          required:
            - jetton_bridge_params
          properties:
            jetton_bridge_params:
              $ref: '#/components/schemas/JettonBridgeParams'
    DomainNames:
      type: object
      required:
        - domains
      properties:
        domains:
          type: array
          items:
            type: string
            example: vasya.ton
    DomainBid:
      type: object
      required:
        - success
        - value
        - txTime
        - bidder
        - txHash
      properties:
        success:
          type: boolean
          example: true
          default: false
        value:
          type: integer
          format: int64
          example: 1660050553
        txTime:
          type: integer
          format: int64
          example: 1660050553
        txHash:
          type: string
          example: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
        bidder:
          $ref: '#/components/schemas/AccountAddress'
    DomainBids:
      type: object
      required:
        - data
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/DomainBid'
    JettonVerificationType:
      type: string
      enum:
        - whitelist
        - graylist
        - blacklist
        - none
    JettonPreview:
      type: object
      required:
        - address
        - name
        - symbol
        - decimals
        - verification
        - image
        - score
      properties:
        address:
          type: string
          format: address
          example: 0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0
        name:
          type: string
          example: Wrapped TON
        symbol:
          type: string
          example: WTON
        decimals:
          type: integer
          example: 9
        image:
          type: string
          example: https://cache.tonapi.io/images/jetton.jpg
        verification:
          $ref: '#/components/schemas/JettonVerificationType'
        custom_payload_api_uri: # todo: maybe remove
          type: string
        score:
          type: integer
          format: int32
        scaled_ui:
          $ref: '#/components/schemas/ScaledUI'
        description:
          type: string
    JettonAssetInfo:
      type: object
      required:
        - token_type
        - defi_provider
      properties:
        # use type
        token_type:
          $ref: '#/components/schemas/DefiAssetType'
        type:
          $ref: '#/components/schemas/DefiAssetType'
        defi_provider:
          $ref: '#/components/schemas/DefiProvider'
        pool_assets:
          $ref: '#/components/schemas/DefiLiquidPoolAssets'
    DefiLiquidPoolAssets:
      type: object
      required:
        - asset0
        - asset1
      properties:
        asset0:
          $ref: '#/components/schemas/DefiLockedAsset'
        asset1:
          $ref: '#/components/schemas/DefiLockedAsset'
    ScaledUI:
      type: object
      required:
        - numerator
        - denominator
      properties:
        numerator:
          type: string
          x-js-format: bigint
          example: "597968399"
        denominator:
          type: string
          x-js-format: bigint
          example: "597968399"
    JettonBalance:
      type: object
      required:
        - balance
        - wallet_address
        - jetton
      properties:
        balance:
          type: string
          x-js-format: bigint
          example: "597968399"
        price:
          $ref: '#/components/schemas/TokenRates'
        wallet_address:
          $ref: '#/components/schemas/AccountAddress'
        jetton:
          $ref: '#/components/schemas/JettonPreview'
        defi_asset:
          $ref: '#/components/schemas/JettonAssetInfo'
        extensions:
          type: array
          items:
            type: string
          example:
            - custom_payload
            - non_transferable
        balance_lt:
          type: integer
          format: int64
          x-js-format: bigint
          description: logical time of the jetton wallet's transaction the balance is as of; absent when unknown, such as for an unclaimed mintless balance
          example: 25713146000001
        lock:
          type: object
          required:
            - amount
            - till
          properties:
            amount:
              type: string
              x-js-format: bigint
              example: "597968399"
            till:
              type: integer
              format: int64
              example: 1678223064
    JettonsBalances:
      type: object
      required:
        - balances
      properties:
        balances:
          type: array
          items:
            $ref: "#/components/schemas/JettonBalance"
    MigrationWallets:
      type: object
      required:
        - wallets
      properties:
        wallets:
          type: array
          items:
            $ref: "#/components/schemas/MigrationWalletValue"
    MigrationWalletValue:
      type: object
      required:
        - account
        - balance
        - status
        - jettons
        - nft_count
      properties:
        account:
          type: string
          format: address
          example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
        balance:
          type: integer
          format: int64
          description: TON balance in nanotons
        status:
          $ref: "#/components/schemas/AccountStatus"
        jettons:
          type: array
          items:
            $ref: "#/components/schemas/JettonBalance"
        nft_count:
          type: integer
          format: int32
          description: number of NFTs owned by the account
    MigrationPrepareRequest:
      type: object
      required:
        - from
        - to
      properties:
        from:
          type: string
          format: address
          description: legacy source wallet to drain
        to:
          type: string
          format: address
          description: destination wallet TON address
        currency:
          type: string
          default: USD
          description: fiat currency for the preview values
          example: USD
        public_key:
          type: string
          description: >
            hex-encoded ed25519 public key of the source wallet.
            If `from` wallet is uninitialized, then public_key is used to infer wallet code
          example: 29c1a72938b8f4f1d4e64f1e3f73e4b0e60f9b0c0e0d0e0f0a0b0c0d0e0f0a0b0
        gas_payer:
          type: string
          enum:
            - self
            - battery
            - gasless
          default: self
          description: >
            Who pays the gas:
              - `self` — the source wallet pays, as usual
              - `battery` — asset transfers are sponsored by the Tonkeeper Battery
              - `gasless` — source wallet pays with jetton, in this case `gas_jetton_master` is required too (only from this list: `/v2/gasless/config`)
        gas_jetton_master:
          type: string
          format: address
          description: >
            Master address of jetton that should be used to cover transactions fees.
            Must be supported by /v2/gasless/config and held by the source wallet.
    MigrationPrepareResponse:
      type: object
      required:
        - from
        - to
        - wallet_version
        - transactions
      properties:
        from:
          type: string
          format: address
        to:
          type: string
          format: address
        wallet_version:
          type: string
          description: source wallet version (informational)
          example: v4R2
        transactions:
          type: array
          description: ordered; sign and broadcast in array order, one entry per external message
          items:
            $ref: "#/components/schemas/MigrationTransaction"
    MigrationPrepareConflict:
      description: >
        The prepared migration together with the reason it cannot be executed as-is. Returned with
        HTTP 409 and error_code 50000 when the source wallet holds migratable assets but not enough
        TON to cover the transfer gas: the transactions are the ones the migration would consist of
        once the source holds `details.required`, so a client can show the full preview next to the
        shortfall instead of re-requesting prepare after the top-up.
      allOf:
        - $ref: '#/components/schemas/MigrationPrepareResponse'
        - type: object
          required:
            - error
          properties:
            error:
              type: string
              example: insufficient GRAM for gas
            error_code:
              type: integer
              format: int64
              description: same extended code as on a plain error response (50000)
            details:
              $ref: '#/components/schemas/InsufficientFunds'
    MigrationTransaction:
      type: object
      required:
        - seqno
        - boc
        - messages
        - emulation
        - gas_spent
      properties:
        seqno:
          type: integer
          format: int32
          description: wallet seqno baked into the unsigned body
        boc:
          type: string
          description: >
            base64 BOC of the unsigned wallet body. The body type is determined by
            (wallet_version, sponsored): for v3/v4 it is always the external body — sign its
            hash, prepend the signature, wrap in an external message; for w5 with
            sponsored=false it is the external body with the signature appended as the
            trailing 512 bits; for w5 with sponsored=true it is the internal_signed body —
            sign and wrap it for /v2/gasless/send as in the gasless flow.
        sponsored:
          type: boolean
          default: false
          description: >
            true — the Battery relay pays gas for this transaction; submit it via
            /v2/gasless/send. false — self-paid; sign and broadcast via
            /v2/blockchain/message as usual. The final TON sweep is always self-paid,
            whatever gas_payer says: the relay does not sponsor a TON-only batch, and
            gasless has no jetton balance left to bill a commission against.
        commission:
          type: string
          description: >
            gasless only; the relay commission in indivisible gas-jetton units, embedded in
            the boc as a jetton transfer to the relay. Exact for the first transaction; an
            estimate for later ones (re-running prepare refreshes it).
        state_init:
          type: string
          format: cell-base64
          description: >
            base64 BOC of the wallet StateInit (code + data).
            Present only on the first transaction when the source wallet is not yet initialized
        messages:
          type: array
          description: >
            ordered raw internal messages carried by this transaction — the cells the wallet
            resends. These are what populate the payload/actions.
          items:
            $ref: "#/components/schemas/MigrationOutMessage"
        emulation:
          $ref: "#/components/schemas/MessageConsequences"
        gas_spent:
          type: integer
          format: int64
          description: >
            TON burned as network fees by this transaction, in nanotons — the sum over every
            transaction in `emulation.trace`. For a transfer batch this is only part of the gas
            attached to its messages: the transfers name the destination wallet as
            response_destination, so the unburned remainder arrives there instead of returning to the
            source. For the final balance sweep it is the fee deducted from the swept amount. When
            `sponsored` is true these fees are covered by the relay, which charges `commission`
            instead.
          example: 4321000
    MigrationOutMessage:
      type: object
      required:
        - boc
        - mode
      properties:
        boc:
          type: string
          format: cell-base64
          description: base64 BOC of the internal message cell the wallet resends
        mode:
          type: integer
          format: int32
          description: send-mode byte (e.g. 3 for a transfer, 128 for the final balance sweep)
    InsufficientFunds:
      type: object
      description: >
        Present on an error when a request failed because the source wallet does not
        hold enough TON to cover the required gas (error_code 50000).
      required:
        - required
        - available
      properties:
        required:
          type: integer
          format: int64
          description: TON in nanotons required to cover transfer gas
          x-js-format: bigint
        available:
          type: integer
          format: int64
          description: TON in nanotons currently available on the source wallet
          x-js-format: bigint
    CurrencyType:
      type: string
      example: jetton
      enum:
        - native
        - extra_currency
        - jetton
        - fiat
    VaultDepositInfo:
      type: object
      required:
        - price
        - vault
      properties:
        price:
          $ref: "#/components/schemas/Price"
        vault:
          type: string
          format: address
          example: 0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0
    Price:
      type: object
      required:
        - currency_type
        - value
        - decimals
        - token_name
        - verification
        - image
      properties:
        currency_type:
          $ref: '#/components/schemas/CurrencyType'
        value:
          type: string
          x-js-format: bigint
          example: "123000000000"
        decimals:
          type: integer
          example: 9
        token_name:
          type: string
          example: Gram
        verification:
          $ref: '#/components/schemas/TrustType'
        image:
          type: string
          example: https://cache.tonapi.io/images/jetton.jpg
        jetton:
          type: string
          format: address
          example: 0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0
    ImagePreview:
      type: object
      required:
        - resolution
        - url
      properties:
        resolution:
          type: string
          example: "100x100"
        url:
          type: string
          example: "https://site.com/pic1.jpg"
    NftApprovedBy:
      type: array
      items:
        type: string
        example: getgems
        enum:
          - getgems
          - tonkeeper
    TrustType:
      type: string
      example: whitelist
      enum:
        - whitelist
        - graylist
        - blacklist
        - none
    Sale:
      type: object
      required:
        - address
        - market
        - price
      properties:
        address:
          type: string
          format: address
          example: 0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
        market:
          $ref: '#/components/schemas/AccountAddress'
        owner:
          $ref: '#/components/schemas/AccountAddress'
        price:
          $ref: '#/components/schemas/Price'
    NftItem:
      type: object
      required:
        - address
        - index
        - verified
        - metadata
        - approved_by
        - trust
      properties:
        address:
          type: string
          format: address
          example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
        index:
          type: integer
          format: int64
          example: 58
        owner:
          $ref: '#/components/schemas/AccountAddress'
        collection:
          type: object
          required:
            - address
            - name
            - description
          properties:
            address:
              type: string
              format: address
              example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
            name:
              type: string
              example: TON Diamonds
            description:
              type: string
              example: "Best collection in TON network"
        verified:
          type: boolean
          description: "Collection master contract confirmed that this item is part of collection"
          example: true
        metadata:
          type: object
          additionalProperties: true
          example: { }
        sale:
          $ref: '#/components/schemas/Sale'
        previews:
          type: array
          items:
            $ref: '#/components/schemas/ImagePreview'
        dns:
          type: string
          example: crypto.ton
        approved_by:
          allOf:
            - $ref: '#/components/schemas/NftApprovedBy'
          deprecated: true
          description: Please use trust field
        include_cnft:
          type: boolean
          example: false
        trust:
          $ref: '#/components/schemas/TrustType'
        code_hash:
          type: string
          description: Hash of the NFT item account code cell (hex)
        data_hash:
          type: string
          description: Hash of the NFT item account data cell (hex)
    NftItems:
      type: object
      required:
        - nft_items
      properties:
        nft_items:
          type: array
          items:
            $ref: '#/components/schemas/NftItem'
    Multisigs:
      type: object
      required:
        - multisigs
      properties:
        multisigs:
          type: array
          items:
            $ref: '#/components/schemas/Multisig'
    Multisig:
      type: object
      required:
        - address
        - seqno
        - threshold
        - signers
        - proposers
        - orders
      properties:
        address:
          type: string
          format: address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        seqno:
          type: string
        threshold:
          type: integer
          format: int32
        signers:
          type: array
          items:
            type: string
            format: address
            example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        proposers:
          type: array
          items:
            type: string
            format: address
            example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        orders:
          type: array
          items:
            $ref: '#/components/schemas/MultisigOrder'
    MultisigOrder:
      type: object
      required:
        - address
        - order_seqno
        - threshold
        - sent_for_execution
        - signers
        - approvals_num
        - expiration_date
        - risk
        - creation_date
        - signed_by
        - multisig_address
      properties:
        address:
          type: string
          format: address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        order_seqno:
          type: string
        threshold:
          type: integer
          format: int32
        sent_for_execution:
          type: boolean
          example: false
        signers:
          type: array
          items:
            type: string
            format: address
            example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        approvals_num:
          type: integer
          format: int32
        expiration_date:
          type: integer
          format: int64
        risk:
          $ref: '#/components/schemas/Risk'
        creation_date:
          type: integer
          format: int64
        signed_by:
          type: array
          items:
            type: string
            format: address
            example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        multisig_address:
          type: string
          format: address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        changing_parameters:
          type: object
          required:
            - threshold
            - signers
            - proposers
          properties:
            threshold:
              type: integer
              format: int32
            signers:
              type: array
              items:
                type: string
                format: address
                example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            proposers:
              type: array
              items:
                type: string
                format: address
    Refund:
      type: object
      required:
        - type
        - origin
      properties:
        type:
          type: string
          example: DNS.ton
          enum:
            - DNS.ton
            - DNS.tg
            - GetGems
        origin:
          type: string
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
    ValueFlow:
      type: object
      required:
        - account
        - gram
        - fees
      properties:
        account:
          $ref: '#/components/schemas/AccountAddress'
        ton:
          type: integer
          format: int64
          x-js-format: bigint
          example: 80
          deprecated: true
          description: "this field will gone after Sept. 2026, use gram instead"
        gram:
          type: integer
          format: int64
          x-js-format: bigint
          example: 80
        fees:
          type: integer
          format: int64
          x-js-format: bigint
          example: 10
        jettons:
          type: array
          items:
            type: object
            required:
              - account
              - qty
              - quantity
              - jetton
            properties:
              account:
                $ref: '#/components/schemas/AccountAddress'
              jetton:
                $ref: '#/components/schemas/JettonPreview'
              qty:
                type: string
                x-js-format: bigint
                example: "200"
              quantity:
                type: integer
                deprecated: true
                format: int64
                x-js-format: bigint
                example: 10
    Action:
      type: object
      required:
        - type
        - status
        - simple_preview
        - base_transactions
      properties:
        type:
          type: string
          example: "TonTransfer"
          enum:
            - TonTransfer
            - ExtraCurrencyTransfer
            - ContractDeploy
            - JettonTransfer
            - FlawedJettonTransfer
            - JettonBurn
            - JettonMint
            - NftItemTransfer
            - Subscribe
            - UnSubscribe
            - AuctionBid
            - NftPurchase
            - DepositStake
            - WithdrawStake
            - WithdrawStakeRequest
            - ElectionsDepositStake
            - ElectionsRecoverStake
            - JettonSwap
            - SmartContractExec
            - DomainRenew
            - Purchase
            - AddExtension
            - RemoveExtension
            - SetSignatureAllowedAction
            - GasRelay
            - DepositTokenStake
            - WithdrawTokenStakeRequest
            - LiquidityDeposit
            - OracleRequest
            - BuyXTR
            - DepositXTR
            - WithdrawXTR
            - Unknown
        status:
          type: string
          example: "ok"
          enum:
            - ok
            - failed
        TonTransfer:
          $ref: '#/components/schemas/TonTransferAction'
        ExtraCurrencyTransfer:
          $ref: '#/components/schemas/ExtraCurrencyTransferAction'
        ContractDeploy:
          $ref: '#/components/schemas/ContractDeployAction'
        JettonTransfer:
          $ref: '#/components/schemas/JettonTransferAction'
        FlawedJettonTransfer:
          $ref: '#/components/schemas/FlawedJettonTransferAction'
        JettonBurn:
          $ref: '#/components/schemas/JettonBurnAction'
        JettonMint:
          $ref: '#/components/schemas/JettonMintAction'
        NftItemTransfer:
          $ref: '#/components/schemas/NftItemTransferAction'
        Subscribe:
          $ref: '#/components/schemas/SubscriptionAction'
        UnSubscribe:
          $ref: '#/components/schemas/UnSubscriptionAction'
        AuctionBid:
          $ref: '#/components/schemas/AuctionBidAction'
        NftPurchase:
          $ref: '#/components/schemas/NftPurchaseAction'
        DepositStake:
          $ref: '#/components/schemas/DepositStakeAction'
        WithdrawStake:
          $ref: '#/components/schemas/WithdrawStakeAction'
        WithdrawStakeRequest:
          $ref: '#/components/schemas/WithdrawStakeRequestAction'
        ElectionsDepositStake:
          $ref: '#/components/schemas/ElectionsDepositStakeAction'
        ElectionsRecoverStake:
          $ref: '#/components/schemas/ElectionsRecoverStakeAction'
        JettonSwap:
          $ref: '#/components/schemas/JettonSwapAction'
        SmartContractExec:
          $ref: '#/components/schemas/SmartContractAction'
        DomainRenew:
          $ref: '#/components/schemas/DomainRenewAction'
        Purchase:
          $ref: '#/components/schemas/PurchaseAction'
        AddExtension:
          $ref: '#/components/schemas/AddExtensionAction'
        RemoveExtension:
          $ref: '#/components/schemas/RemoveExtensionAction'
        SetSignatureAllowedAction:
          $ref: '#/components/schemas/SetSignatureAllowedAction'
        GasRelay:
          $ref: '#/components/schemas/GasRelayAction'
        DepositTokenStake:
          $ref: '#/components/schemas/DepositTokenStakeAction'
        WithdrawTokenStakeRequest:
          $ref: '#/components/schemas/WithdrawTokenStakeRequestAction'
        LiquidityDeposit:
          $ref: '#/components/schemas/LiquidityDepositAction'
        OracleRequest:
          $ref: '#/components/schemas/OracleRequestAction'
        WithdrawXTR:
          $ref: '#/components/schemas/WithdrawXTRAction'
        DepositXTR:
          $ref: '#/components/schemas/DepositXTRAction'
        BuyXTR:
          $ref: '#/components/schemas/BuyXTRAction'
        simple_preview:
          $ref: '#/components/schemas/ActionSimplePreview'
        base_transactions:
          type: array
          items:
            type: string
            description: "transaction hash"
            example: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
    TonTransferAction:
      type: object
      required:
        - sender
        - recipient
        - amount
      properties:
        sender:
          $ref: '#/components/schemas/AccountAddress'
        recipient:
          $ref: '#/components/schemas/AccountAddress'
        amount:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        comment:
          type: string
          example: "Hi! This is your salary. \nFrom accounting with love."
        encrypted_comment:
          $ref: '#/components/schemas/EncryptedComment'
        refund:
          $ref: '#/components/schemas/Refund'
    OracleRequestAction:
      type: object
      required:
        - requester
        - response_to
        - price_feeds
      properties:
        requester:
          $ref: '#/components/schemas/AccountAddress'
        response_to:
          $ref: '#/components/schemas/AccountAddress'
        price_feeds:
          type: array
          items:
            $ref: '#/components/schemas/OraclePriceFeed'
    OraclePriceFeed:
      type: object
      required:
        - id
        - display_symbol
      properties:
        id:
          type: string
          example: e62df6c8b4a85fe1a67f1c4d1f1e1d4335c04d1d7e2c50e0d7da7ad911f2d4
        display_symbol:
          type: string
          example: GRAM/USD
        rate:
          type: number
          format: double
          example: 5.24
    DepositXTRAction:
      type: object
      required:
        - recipient
        - amount
      properties:
        recipient:
          $ref: '#/components/schemas/AccountAddress'
        amount:
          type: string
          x-js-format: bigint
          example: "123000000000"
    BuyXTRAction:
      type: object
      required:
        - recipient
        - amount
      properties:
        recipient:
          $ref: '#/components/schemas/AccountAddress'
        amount:
          type: string
          x-js-format: bigint
          example: "123000000000"
    WithdrawXTRAction:
      type: object
      required:
        - user
        - amount
      properties:
        user:
          $ref: '#/components/schemas/AccountAddress'
        amount:
          type: string
          x-js-format: bigint
          example: "123000000000"
    ExtraCurrencies:
      type: object
      required:
        - extra_currencies
      properties:
        extra_currencies:
          type: array
          items:
            $ref: '#/components/schemas/EcPreview'
    EcPreview:
      type: object
      required:
        - id
        - symbol
        - decimals
        - image
      properties:
        id:
          type: integer
          example: 239
          format: int32
        symbol:
          type: string
          example: FMS
        decimals:
          type: integer
          example: 5
        image:
          type: string
          example: https://cache.tonapi.io/images/extra.jpg
    ExtraCurrencyTransferAction:
      type: object
      required:
        - sender
        - recipient
        - amount
        - currency
      properties:
        sender:
          $ref: '#/components/schemas/AccountAddress'
        recipient:
          $ref: '#/components/schemas/AccountAddress'
        amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
          description: amount in quanta of tokens
        comment:
          type: string
          example: "Hi! This is your salary. \nFrom accounting with love."
        encrypted_comment:
          $ref: '#/components/schemas/EncryptedComment'
        currency:
          $ref: '#/components/schemas/EcPreview'
    SmartContractAction:
      type: object
      required:
        - executor
        - contract
        - gram_attached
        - operation
      properties:
        executor:
          $ref: '#/components/schemas/AccountAddress'
        contract:
          $ref: '#/components/schemas/AccountAddress'
        ton_attached:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
          deprecated: true
        gram_attached:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        operation:
          type: string
          example: "NftTransfer or 0x35d95a12"
        payload:
          type: string
          # example ??, maybe cell?
        refund:
          $ref: '#/components/schemas/Refund'
    DomainRenewAction:
      type: object
      required:
        - domain
        - contract_address
        - renewer
      properties:
        domain:
          type: string
          example: "vasya.ton"
        contract_address:
          type: string
          format: address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        renewer:
          $ref: '#/components/schemas/AccountAddress'
    GasRelayAction:
      type: object
      required:
        - amount
        - relayer
        - target
      properties:
        amount:
          type: integer
          format: int64
          x-js-format: bigint
          example: 1000000000
        relayer:
          $ref: '#/components/schemas/AccountAddress'
        target:
          $ref: '#/components/schemas/AccountAddress'
        is_battery:
          type: boolean
        relayer_fee:
          $ref: '#/components/schemas/GasRelayFee'
    GasRelayFee:
      type: object
      required:
        - jetton
        - amount
      properties:
        jetton:
          $ref: '#/components/schemas/JettonPreview'
        amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
          description: amount in quanta of tokens
    PurchaseAction:
      type: object
      required:
        - source
        - destination
        - invoice_id
        - amount
        - metadata
      properties:
        source:
          $ref: '#/components/schemas/AccountAddress'
        destination:
          $ref: '#/components/schemas/AccountAddress'
        invoice_id:
          type: string
          example: 03cfc582-b1c3-410a-a9a7-1f3afe326b3b
        amount:
          $ref: '#/components/schemas/Price'
        metadata:
          $ref: '#/components/schemas/Metadata'
    AddExtensionAction:
      type: object
      required:
        - wallet
        - extension
      properties:
        wallet:
          $ref: '#/components/schemas/AccountAddress'
        extension:
          type: string
          format: address
          example: 0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
    RemoveExtensionAction:
      type: object
      required:
        - wallet
        - extension
      properties:
        wallet:
          $ref: '#/components/schemas/AccountAddress'
        extension:
          type: string
          format: address
          example: 0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
    SetSignatureAllowedAction:
      type: object
      required:
        - wallet
        - allowed
      properties:
        wallet:
          $ref: '#/components/schemas/AccountAddress'
        allowed:
          type: boolean
    NftItemTransferAction:
      type: object
      required:
        - nft
      properties:
        sender:
          $ref: '#/components/schemas/AccountAddress'
        recipient:
          $ref: '#/components/schemas/AccountAddress'
        nft:
          type: string
          format: maybe-address
          example: ""
        comment:
          type: string
          example: "Hi! This is your salary. \nFrom accounting with love."
        encrypted_comment:
          $ref: '#/components/schemas/EncryptedComment'
        payload:
          type: string
          description: raw hex encoded payload
          example: '0234de3e21d21b3ee21f3'
        refund:
          $ref: '#/components/schemas/Refund'
    JettonTransferAction:
      type: object
      required:
        - amount
        - jetton
        - senders_wallet
        - recipients_wallet
      properties:
        sender:
          $ref: '#/components/schemas/AccountAddress'
        recipient:
          $ref: '#/components/schemas/AccountAddress'
        senders_wallet:
          type: string
          format: address
          example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
        recipients_wallet:
          type: string
          format: address
          example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
        amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
          description: amount in quanta of tokens
        comment:
          type: string
          example: "Hi! This is your salary. \nFrom accounting with love."
        encrypted_comment:
          $ref: '#/components/schemas/EncryptedComment'
        refund:
          $ref: '#/components/schemas/Refund'
        jetton:
          $ref: '#/components/schemas/JettonPreview'
    FlawedJettonTransferAction:
      type: object
      required:
        - sent_amount
        - received_amount
        - jetton
        - senders_wallet
        - recipients_wallet
      properties:
        sender:
          $ref: '#/components/schemas/AccountAddress'
        recipient:
          $ref: '#/components/schemas/AccountAddress'
        senders_wallet:
          type: string
          format: address
          example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
        recipients_wallet:
          type: string
          format: address
          example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
        sent_amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
          description: sent amount in quanta of tokens
        received_amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
          description: actually received amount in quanta of tokens
        comment:
          type: string
          example: "Hi! This is your salary. \nFrom accounting with love."
        encrypted_comment:
          $ref: '#/components/schemas/EncryptedComment'
        refund:
          $ref: '#/components/schemas/Refund'
        jetton:
          $ref: '#/components/schemas/JettonPreview'
    JettonBurnAction:
      type: object
      required:
        - amount
        - jetton
        - sender
        - senders_wallet
      properties:
        sender:
          $ref: '#/components/schemas/AccountAddress'
          description: Account that sent the burn message.
        owner:
          $ref: '#/components/schemas/AccountAddress'
          description: Owner of the jetton wallet the tokens were burned from. Equals `sender` unless someone else initiated the burn (e.g. the jetton master forcing a burn).
        senders_wallet:
          type: string
          format: address
          example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
        amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
          description: amount in quanta of tokens
        jetton:
          $ref: '#/components/schemas/JettonPreview'
    JettonMintAction:
      type: object
      required:
        - amount
        - jetton
        - recipient
        - recipients_wallet
      properties:
        recipient:
          $ref: '#/components/schemas/AccountAddress'
        recipients_wallet:
          type: string
          format: address
          example: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
        amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
          description: amount in quanta of tokens
        jetton:
          $ref: '#/components/schemas/JettonPreview'
    ContractDeployAction:
      type: object
      required:
        - address
        - interfaces
      properties:
        address:
          type: string
          format: address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        interfaces:
          type: array
          items:
            type: string
          example: [ "nft_item", "nft_royalty" ]
    SubscriptionAction:
      type: object
      required:
        - subscriber
        - subscription
        - beneficiary
        - admin
        - price
        - initial
      properties:
        subscriber:
          $ref: '#/components/schemas/AccountAddress'
        subscription:
          type: string
          format: address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        beneficiary:
          $ref: '#/components/schemas/AccountAddress'
        admin:
          $ref: '#/components/schemas/AccountAddress'
        amount:
          deprecated: true
          type: integer
          format: int64
          example: 1000000000
          x-js-format: bigint
        price:
          $ref: '#/components/schemas/Price'
        initial:
          type: boolean
          example: false
    UnSubscriptionAction:
      type: object
      required:
        - subscriber
        - subscription
        - beneficiary
        - admin
      properties:
        subscriber:
          $ref: '#/components/schemas/AccountAddress'
        subscription:
          type: string
          format: address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        beneficiary:
          $ref: '#/components/schemas/AccountAddress'
        admin:
          $ref: '#/components/schemas/AccountAddress'
    AuctionBidAction:
      type: object
      required:
        - amount
        - bidder
        - auction
        - auction_type
      properties:
        auction_type:
          type: string
          enum:
            - DNS.ton
            - DNS.tg
            - NUMBER.tg
            - getgems
        amount:
          $ref: '#/components/schemas/Price'
        nft:
          $ref: '#/components/schemas/NftItem'
        bidder:
          $ref: '#/components/schemas/AccountAddress'
        auction:
          $ref: '#/components/schemas/AccountAddress'
    DepositStakeAction:
      description: "validator's participation in elections"
      type: object
      required:
        - amount
        - staker
        - pool
        - implementation
      properties:
        amount:
          type: integer
          format: int64
          x-js-format: bigint
          example: 1660050553
        staker:
          $ref: '#/components/schemas/AccountAddress'
        pool:
          $ref: '#/components/schemas/AccountAddress'
        implementation:
          $ref: '#/components/schemas/PoolImplementationType'
        stake_meta:
          description: "If present, should be used instead of amount"
          $ref: '#/components/schemas/Price'
    WithdrawStakeAction:
      description: "validator's participation in elections"
      type: object
      required:
        - amount
        - staker
        - pool
        - implementation
      properties:
        amount:
          type: integer
          format: int64
          example: 1660050553
          x-js-format: bigint
        staker:
          $ref: '#/components/schemas/AccountAddress'
        pool:
          $ref: '#/components/schemas/AccountAddress'
        implementation:
          $ref: '#/components/schemas/PoolImplementationType'
    WithdrawStakeRequestAction:
      description: "validator's participation in elections"
      type: object
      required:
        - staker
        - pool
        - implementation
      properties:
        amount:
          type: integer
          format: int64
          example: 1660050553
          x-js-format: bigint
        staker:
          $ref: '#/components/schemas/AccountAddress'
        pool:
          $ref: '#/components/schemas/AccountAddress'
        implementation:
          $ref: '#/components/schemas/PoolImplementationType'
        stake_meta:
          description: "If present, should be used instead of amount"
          $ref: '#/components/schemas/Price'
    ElectionsRecoverStakeAction:
      type: object
      required:
        - amount
        - staker
      properties:
        amount:
          type: integer
          format: int64
          example: 1660050553
          x-js-format: bigint
        staker:
          $ref: '#/components/schemas/AccountAddress'
    ElectionsDepositStakeAction:
      type: object
      required:
        - amount
        - staker
      properties:
        amount:
          type: integer
          format: int64
          example: 1660050553
          x-js-format: bigint
        staker:
          $ref: '#/components/schemas/AccountAddress'
    JettonSwapAction:
      type: object
      required:
        - dex
        - amount_in
        - amount_out
        - user_wallet
        - router
      properties:
        dex:
          type: string
          example: "stonfi"
        amount_in:
          type: string
          x-js-format: bigint
          example: "1660050553"
        amount_out:
          type: string
          x-js-format: bigint
          example: "1660050553"
        ton_in:
          type: integer
          example: 1000000000
          format: int64
          x-js-format: bigint
          deprecated: true
          description: this field will gone after Sept. 2026, use gram_in instead
        ton_out:
          type: integer
          example: 2000000000
          format: int64
          x-js-format: bigint
          deprecated: true
          description: this field will gone after Sept. 2026, use gram_out instead
        gram_in:
          type: integer
          example: 1000000000
          format: int64
          x-js-format: bigint
        gram_out:
          type: integer
          example: 2000000000
          format: int64
          x-js-format: bigint
        user_wallet:
          $ref: '#/components/schemas/AccountAddress'
        router:
          $ref: '#/components/schemas/AccountAddress'
        jetton_master_in:
          $ref: '#/components/schemas/JettonPreview'
        jetton_master_out:
          $ref: '#/components/schemas/JettonPreview'
    NftPurchaseAction:
      type: object
      required:
        - amount
        - seller
        - buyer
        - auction_type
        - nft
      properties:
        auction_type:
          type: string
          enum:
            - DNS.ton
            - DNS.tg
            - NUMBER.tg
            - getgems
        amount:
          $ref: '#/components/schemas/Price'
        nft:
          $ref: '#/components/schemas/NftItem'
        seller:
          $ref: '#/components/schemas/AccountAddress'
        buyer:
          $ref: '#/components/schemas/AccountAddress'
    DepositTokenStakeAction:
      type: object
      required:
        - staker
        - protocol
      properties:
        staker:
          $ref: '#/components/schemas/AccountAddress'
        protocol:
          $ref: '#/components/schemas/Protocol'
        stake_meta:
          $ref: '#/components/schemas/Price'
    WithdrawTokenStakeRequestAction:
      type: object
      required:
        - staker
        - protocol
      properties:
        staker:
          $ref: '#/components/schemas/AccountAddress'
        protocol:
          $ref: '#/components/schemas/Protocol'
        stake_meta:
          $ref: '#/components/schemas/Price'
    LiquidityDepositAction:
      type: object
      required:
        - protocol
        - from
        - tokens
      properties:
        protocol:
          $ref: '#/components/schemas/Protocol'
        from:
          $ref: '#/components/schemas/AccountAddress'
        tokens:
          type: array
          items:
            $ref: '#/components/schemas/VaultDepositInfo'
    ActionSimplePreview:
      type: object
      description: shortly describes what this action is about.
      required:
        - name
        - description
        - accounts
      properties:
        name:
          type: string
          example: "Gram Transfer"
        description:
          type: string
          example: "Transferring 5 Gram"
        action_image:
          type: string
          description: a link to an image for this particular action.
        value:
          type: string
          example: "5 Gram"
        fiat_value:
          type: string
          description: the value of this action expressed in the requested fiat currency.
          example: "4.99 USD"
        value_image:
          type: string
          description: a link to an image that depicts this action's asset.
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/AccountAddress'
    AccountEvent:
      type: object
      description: >
        High-level view over a transaction trace caused by a single inbound message.
        TonAPI analyses the trace, detects known patterns and groups low-level transactions
        into user-facing actions (Jetton transfer, NFT purchase, etc.). Actions are a
        best-effort UI abstraction and may change; do not rely on them for protocol-critical logic.
      required:
        - event_id
        - timestamp
        - actions
        - account
        - is_scam
        - lt
        - in_progress
        - extra
        - progress
      properties:
        event_id:
          type: string
          example: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
        account:
          $ref: '#/components/schemas/AccountAddress'
        timestamp:
          type: integer
          format: int64
          example: 1234567890
        actions:
          type: array
          items:
            $ref: '#/components/schemas/Action'
        is_scam:
          type: boolean
          description: scam
          example: false
        lt:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
        in_progress:
          type: boolean
          example: false
          description: Event trace is not finished yet. Transactions still happening.
        extra:
          type: integer
          format: int64
          x-js-format: bigint
          example: 3
          description: >
            Net Gram change for this account not explained by actions, in nanograms:
            extra = final_balance - initial_balance - sum(explicit Gram changes from actions).
            extra < 0 - implicit fee, extra > 0 - refund. For UI display only
        progress:
          type: number
          format: float
          minimum: 0
          maximum: 1
          example: 0.5
          description: Event completion ratio in [0,1]
        ext_msg_hash:
          type: string
          description: Normalized hash of the root external inbound message (hex).
          example: a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456
    AccountEvents:
      type: object
      description: Paginated list of events for a single account.
      required:
        - events
        - next_from
      properties:
        events:
          type: array
          items:
            $ref: '#/components/schemas/AccountEvent'
        next_from:
          type: integer
          format: int64
          example: 25713146000001
    Purchase:
      type: object
      required:
        - event_id
        - invoice_id
        - source
        - destination
        - lt
        - utime
        - amount
        - metadata
      properties:
        event_id:
          type: string
          example: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
        invoice_id:
          type: string
          example: 03cfc582-b1c3-410a-a9a7-1f3afe326b3b
        source:
          $ref: '#/components/schemas/AccountAddress'
        destination:
          $ref: '#/components/schemas/AccountAddress'
        lt:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
        utime:
          type: integer
          format: int64
          example: 1645544908
        amount:
          $ref: '#/components/schemas/Price'
        metadata:
          $ref: '#/components/schemas/Metadata'
    AccountPurchases:
      type: object
      required:
        - purchases
        - next_from
      properties:
        purchases:
          type: array
          items:
            $ref: '#/components/schemas/Purchase'
        next_from:
          type: integer
          format: int64
          example: 25713146000001
    Metadata:
      type: object
      required:
        - encrypted_binary
      properties:
        encrypted_binary:
          type: string
          description: hex encoded bytes
        decryption_key:
          type: string
          description: hex encoded bytes
          example: "dead.....beef"
    TraceID:
      type: object
      required:
        - id
        - utime
      properties:
        id:
          type: string
          example: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
        utime:
          type: integer
          format: int64
          example: 1645544908
    TraceIDs:
      type: object
      required:
        - traces
      properties:
        traces:
          type: array
          items:
            $ref: '#/components/schemas/TraceID'
    ApyHistory:
      type: object
      required:
        - apy
        - time
      properties:
        apy:
          type: number
        time:
          type: integer
    Subscription:
      type: object
      required:
        - type
        - status
        - period
        - subscription_id
        - payment_per_period
        - wallet
        - next_charge_at
        - metadata
      properties:
        type:
          type: string
          description: type of subscription
          example: v2
        status:
          type: string
          enum:
            - not_ready
            - active
            - suspended
            - cancelled
        period:
          type: integer
          description: payment period in seconds
          format: int64
          example: 2592000
        subscription_id:
          type: string
          description: common identifier
        payment_per_period:
          $ref: '#/components/schemas/Price'
        wallet:
          $ref: '#/components/schemas/AccountAddress'
        next_charge_at:
          type: integer
          format: int64
          example: 1653996834
        metadata:
          $ref: '#/components/schemas/Metadata'
        address:
          type: string
          format: maybe-address
          example: 0:dea8f638b789172ce36d10a20318125e52c649aa84893cd77858224fe2b9b0ee
        beneficiary:
          $ref: '#/components/schemas/AccountAddress'
        admin:
          $ref: '#/components/schemas/AccountAddress'
    Subscriptions:
      type: object
      required:
        - subscriptions
      properties:
        subscriptions:
          type: array
          items:
            $ref: '#/components/schemas/Subscription'
    Auction:
      type: object
      required:
        - domain
        - owner
        - price
        - bids
        - date
      properties:
        domain:
          type: string
          example: wallet.ton
        owner:
          type: string
          format: address
          example: 0:c704dadfabac88eab58e340de03080df81ff76636431f48624ad6e26fb2da0a4
        price:
          type: integer
          format: int64
          example: 1660050553
          x-js-format: bigint
        bids:
          type: integer
          format: int64
          example: 1660050553
          x-js-format: bigint
        date:
          type: integer
          format: int64
          example: 1660050553
    Auctions:
      type: object
      required:
        - data
        - total
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Auction'
        total:
          type: integer
          format: int64
          example: 1660050553
    WalletDNS:
      type: object
      required:
        - address
        - is_wallet
        - has_method_pubkey
        - has_method_seqno
        - names
        - account
      properties:
        address:
          type: string
          format: address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        account:
          $ref: '#/components/schemas/AccountAddress'
        is_wallet:
          type: boolean
          example: true
        has_method_pubkey:
          type: boolean
          example: true
        has_method_seqno:
          type: boolean
          example: true
        names:
          type: array
          items:
            type: string
            example: "name"
    DomainInfo:
      type: object
      required:
        - name
      properties:
        name:
          type: string
        expiring_at:
          type: integer
          format: int64
          description: date of expiring. optional. not all domain in ton has expiration date
        item:
          $ref: '#/components/schemas/NftItem'
    DnsRecord:
      type: object
      required:
        - sites
      properties:
        wallet:
          $ref: '#/components/schemas/WalletDNS'
        next_resolver:
          type: string
          format: maybe-address
          example: "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        sites:
          type: array
          items:
            type: string
            example: "http://12234.ton"
        storage:
          type: string
          description: "tonstorage bag id"
          example: "da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        picture:
          $ref: '#/components/schemas/PictureDNS'
    PictureDNS:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - url
            - bag_id
        url:
          type: string
          description: |
            WARNING! This is arbitrary url supplied by domain owner, use it very carefully.
            There is no guarantee that URL resolves to an image file and is not a phishing site.
        bag_id:
          type: string
    NftCollection:
      type: object
      required:
        - address
        - next_item_index
        - raw_collection_content
        - approved_by
        - trust
      properties:
        address:
          type: string
          format: address
          example: 0:FD595F36B4C1535BEC8461490D38EBB9AE3C38DD6ACE17CA63ABE2C6608BE159
        next_item_index:
          type: integer
          format: int64
          example: 1
        owner:
          $ref: '#/components/schemas/AccountAddress'
        raw_collection_content:
          type: string
          format: cell
        metadata:
          type: object
          additionalProperties: true
          example: { }
        previews:
          type: array
          items:
            $ref: '#/components/schemas/ImagePreview'
        approved_by:
          $ref: '#/components/schemas/NftApprovedBy'
        trust:
          $ref: '#/components/schemas/TrustType'
        metadata_status:
          $ref: '#/components/schemas/NftCollectionMetadataStatus'
    NftCollections:
      type: object
      required:
        - nft_collections
      properties:
        nft_collections:
          type: array
          items:
            $ref: '#/components/schemas/NftCollection'
    NftCollectionMetadataStatus:
      type: object
      properties:
        url:
          type: string
        is_broken:
          type: boolean
        last_refresh_try:
          type: integer
          format: int64
          nullable: true
        last_refresh_success:
          type: integer
          format: int64
          nullable: true
    Trace:
      type: object
      required:
        - transaction
        - interfaces
      properties:
        transaction:
          $ref: '#/components/schemas/Transaction'
        interfaces:
          type: array
          items:
            type: string
          example: [ "wallet", "tep62_item" ]
        children:
          type: array
          items:
            $ref: '#/components/schemas/Trace'
        emulated:
          type: boolean
          example: false
    MessageConsequences:
      type: object
      description: >
        Result of emulating a wallet message on the current blockchain state: describes the expected
        on-chain consequences (trace, high-level AccountEvent, risk) for the signing wallet. For UI display only.
      required:
        - trace
        - risk
        - event
      properties:
        trace:
          $ref: '#/components/schemas/Trace'
        risk:
          $ref: '#/components/schemas/Risk'
        event:
          $ref: '#/components/schemas/AccountEvent'
    Risk:
      type: object
      description: >
        Conservative upper bound on assets this wallet may lose if the emulated message is sent
        and the counterparty behaves maliciously. Values may exceed current balances
        (e.g. already-authorized future receipts). For UI display only.
      required:
        - transfer_all_remaining_balance
        - gram
        - jettons
        - nfts
      properties:
        transfer_all_remaining_balance:
          type: boolean
          description: >
            True if the message semantics allow sweeping all current and future remaining Gram
            balance of the wallet (e.g. “send all” / drain patterns).
          example: true
        ton:
          type: integer
          format: int64
          x-js-format: bigint
          example: 500
          deprecated: true
          description: this field will gone after Sept. 2026, use gram instead
        gram:
          type: integer
          format: int64
          x-js-format: bigint
          example: 500
          description: Maximum Gram amount that may leave the wallet in the worst case, in nanogram.
        jettons:
          type: array
          description: Jetton positions that may be debited from the wallet in the worst case.
          items:
            $ref: '#/components/schemas/JettonQuantity'
        nfts:
          type: array
          description: NFT items that may be transferred out of the wallet in the worst case.
          items:
            $ref: '#/components/schemas/NftItem'
        total_equivalent:
          type: number
          format: float
          description: >
            Estimated equivalent of all assets at risk (Gram, jettons, NFTs) in the selected
            currency from currencyQuery (e.g. USD). Approximate, best-effort UI value.
    JettonQuantity:
      type: object
      required:
        - quantity
        - wallet_address
        - jetton
      properties:
        quantity:
          type: string
          x-js-format: bigint
          example: "597968399"
        wallet_address:
          $ref: '#/components/schemas/AccountAddress'
        jetton:
          $ref: '#/components/schemas/JettonPreview'
    DecodedMessage:
      type: object
      required:
        - destination
        - destination_wallet_version
      properties:
        destination:
          $ref: '#/components/schemas/AccountAddress'
        destination_wallet_version:
          type: string
          example: "v3R2"
        ext_in_msg_decoded:
          type: object
          properties:
            wallet_v3:
              type: object
              required:
                - subwallet_id
                - valid_until
                - seqno
                - op
                - raw_messages
              properties:
                subwallet_id:
                  type: integer
                  format: int64
                  example: 1
                valid_until:
                  type: integer
                  format: int64
                  example: 1
                seqno:
                  type: integer
                  format: int64
                  example: 1
                raw_messages:
                  type: array
                  items:
                    $ref: '#/components/schemas/DecodedRawMessage'
            wallet_v4:
              type: object
              required:
                - subwallet_id
                - valid_until
                - seqno
                - op
                - raw_messages
              properties:
                subwallet_id:
                  type: integer
                  format: int64
                  example: 1
                valid_until:
                  type: integer
                  format: int64
                  example: 1
                seqno:
                  type: integer
                  format: int64
                  example: 1
                op:
                  type: integer
                  format: int32
                  example: 1
                raw_messages:
                  type: array
                  items:
                    $ref: '#/components/schemas/DecodedRawMessage'
            wallet_v5:
              type: object
              required:
                - raw_messages
                - valid_until
              properties:
                valid_until:
                  type: integer
                  format: int64
                  example: 1
                raw_messages:
                  type: array
                  items:
                    $ref: '#/components/schemas/DecodedRawMessage'
            wallet_highload_v2:
              type: object
              required:
                - subwallet_id
                - bounded_query_id
                - raw_messages
              properties:
                subwallet_id:
                  type: integer
                  format: int64
                  example: 1
                bounded_query_id:
                  type: string
                  example: "34254528475294857"
                raw_messages:
                  type: array
                  items:
                    $ref: '#/components/schemas/DecodedRawMessage'
    DecodedRawMessage:
      type: object
      required:
        - message
        - mode
      properties:
        message:
          type: object
          required:
            - boc
          properties:
            boc:
              type: string
              format: cell
            decoded_op_name:
              type: string
              example: "nft_transfer"
            op_code:
              type: string
              x-js-format: bigint
              example: "0xdeadbeaf"
            decoded_body: { } # Free-form JSON value
        mode:
          type: integer
          example: 2
    Event:
      type: object
      required:
        - event_id
        - timestamp
        - actions
        - value_flow
        - is_scam
        - lt
        - in_progress
        - progress
      properties:
        event_id:
          type: string
          example: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
        timestamp:
          type: integer
          format: int64
          example: 1234567890
        actions:
          type: array
          items:
            $ref: '#/components/schemas/Action'
        value_flow:
          type: array
          items:
            $ref: '#/components/schemas/ValueFlow'
        is_scam:
          type: boolean
          description: scam
          example: false
        lt:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
        in_progress:
          type: boolean
          example: false
          description: Event trace is not finished yet. Transactions still happening.
        progress:
          type: number
          format: float
          minimum: 0
          maximum: 1
          example: 0.5
        last_slice_id:
          type: integer
          format: int64
          description: ID of the slice where this event was finalized. Null if not yet finalized.
          example: 12345678
        ext_msg_hash:
          type: string
          description: Normalized hash of the root external inbound message (hex).
          example: a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456
    JettonMetadata:
      type: object
      required:
        - address
        - name
        - symbol
        - decimals
      properties:
        address:
          type: string
          format: address
          example: 0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0
        name:
          type: string
          example: Wrapped TON
        symbol:
          type: string
          example: WTON
        decimals:
          type: string
          example: "9"
        image:
          type: string
          example: "https://bitcoincash-example.github.io/website/logo.png"
          description: this field currently returns a cached image URL (e.g., "https://cache.tonapi.io/images/jetton.jpg"). In the future, this will be replaced with the original URL from the metadata. The cached image is already available in the `preview` field of `JettonInfo` and will remain there.
        description:
          type: string
          example: Wrapped Gram
        social:
          type: array
          items:
            type: string
            example: [ "https://t.me/durov_coin", "https://twitter.com/durov_coin" ]
        websites:
          type: array
          items:
            type: string
            example: [ "https://durov.coin", "ton://durov-coin.ton" ]
        catalogs:
          type: array
          items:
            type: string
            example: [ "https://coinmarketcap.com/currencies/drv/", "https://www.coingecko.com/en/coins/durov" ]
        custom_payload_api_uri:
          type: string
          example: "https://claim-api.tonapi.io/jettons/TESTMINT"
    Jettons:
      type: object
      required:
        - jettons
      properties:
        jettons:
          type: array
          items:
            $ref: '#/components/schemas/JettonInfo'
    JettonInfo:
      type: object
      required:
        - mintable
        - total_supply
        - metadata
        - verification
        - holders_count
        - preview
      properties:
        mintable:
          type: boolean
          example: true
        total_supply:
          type: string
          x-js-format: bigint
          example: "5887105890579978"
        admin:
          $ref: '#/components/schemas/AccountAddress'
        metadata:
          $ref: '#/components/schemas/JettonMetadata'
        preview:
          type: string
          example: "https://cache.tonapi.io/images/jetton.jpg"
        verification:
          $ref: '#/components/schemas/JettonVerificationType'
        holders_count:
          type: integer
          format: int32
          example: 2000
        scaled_ui:
          $ref: '#/components/schemas/ScaledUI'
        code_hash:
          type: string
          description: base64-encoded hash of jetton master code cell
          example: 'rOIINk/O5kGub/FI/RARmMN6SY7BLesBSOonmxrz5f4='
        data_hash:
          type: string
          description: base64-encoded hash of jetton master data cell
          example: 'xd7cWaRQdVSysuG+WVJv9KRuRUGxnehLoByEcK5ukOE='
        last_transaction_lt:
          type: string
          x-js-format: bigint
          description: last transaction lt of the jetton master account
          example: '26640202000003'
        name:
          type: string
          nullable: true
          description: DNS name resolving to this address (e.g. admin.ton)
          example: "admin.ton"
        interfaces:
          type: array
          items:
            type: string
          description: Contract interfaces implemented by the account (e.g. multisig_v2, wallet_v3r2)
          example: ["multisig_v2", "wallet_v3r2"]
    JettonHolders:
      type: object
      required:
        - addresses
        - total
      properties:
        addresses:
          type: array
          items:
            type: object
            required:
              - address
              - owner
              - balance
            properties:
              address:
                type: string
                format: address
                example: 0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
              owner:
                $ref: '#/components/schemas/AccountAddress'
              balance:
                type: string
                x-js-format: bigint
                example: "168856200518084"
                description: balance in the smallest jetton's units
        total:
          type: integer
          format: int64
          description: total number of holders
          example: 2000
    JettonTransferPayload:
      type: object
      required:
        - payload
      properties:
        custom_payload:
          type: string
          # format: ???
          example: "b5ee9c72410212010001b40009460395b521c9251151ae7987e03c544bd275d6cd42c2d157f840beb14d5454b96718000d012205817002020328480101fd7f6a648d4f771d7f0abc1707e4e806b19de1801f65eb8c133a4cfb0c33d847000b22012004052848010147da975b922d89192f4c9b68a640daa6764ec398c93cec025e17f0c1852a711a0009220120061122012007082848010170d9fb0423cbef6c2cf1f3811a2f640daf8c9a326b6f8816c1b993e90d88e2100006220120090a28480101f6df1d75f6b9e45f224b2cb4fc2286d927d47b468b6dbf1fedc4316290ec2ae900042201200b102201200c0f2201200d"
          description: "hex-encoded BoC"
        state_init:
          type: string
          # format: ???
          example: "b5ee9c72410212010001b40009460395b521c9251151ae7987e03c544bd275d6cd42c2d157f840beb14d5454b96718000d012205817002020328480101fd7f6a648d4f771d7f0abc1707e4e806b19de1801f65eb8c133a4cfb0c33d847000b22012004052848010147da975b922d89192f4c9b68a640daa6764ec398c93cec025e17f0c1852a711a0009220120061122012007082848010170d9fb0423cbef6c2cf1f3811a2f640daf8c9a326b6f8816c1b993e90d88e2100006220120090a28480101f6df1d75f6b9e45f224b2cb4fc2286d927d47b468b6dbf1fedc4316290ec2ae900042201200b102201200c0f2201200d"
          description: "hex-encoded BoC"
    DefiAssets:
      type: object
      required:
        - assets
      properties:
        assets:
          type: array
          items:
            $ref: '#/components/schemas/DefiAsset'
    DefiAssetType:
      type: string
      enum:
        - staking
        - lending_supply
        - lending_borrow
        - liquid_staking
        - liquid_pool
        - yield_token
    DefiAsset:
      type: object
      required:
        - type
        - amount
        - defi_provider
        - locked_asset
      properties:
        type:
          $ref: '#/components/schemas/DefiAssetType'
        amount:
          type: string
          x-js-format: bigint
          description: amount in minimal units of the locked asset
          example: "1000000000"
        pool_address:
          type: string
          format: address
        asset_address:
          type: string
          format: address
        defi_provider:
          $ref: '#/components/schemas/DefiProvider'
        locked_asset:
          $ref: '#/components/schemas/DefiLockedAsset'
    DefiLockedAsset:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          description: native Gram or jetton asset
          enum:
            - native
            - jetton
        jetton:
          $ref: '#/components/schemas/JettonPreview'
    DefiProvider:
      type: object
      required:
        - name
        - description
        - link
        - icon
        - card
        - full
        - tag
      properties:
        name:
          type: string
          example: Morpho
        description:
          type: string
          example: Earn up to 15% yield on your crypto
        link:
          type: string
          example: https://lite.morpho.org/tac/earn/
        miniapp_link:
          type: string
          example: https://t.me/MorphoOrgBot
        icon:
          type: string
        card:
          type: string
        full:
          type: string
        tag:
          type: string
          example: morpho
    AccountStaking:
      type: object
      required:
        - pools
      properties:
        pools:
          type: array
          items:
            $ref: '#/components/schemas/AccountStakingInfo'
    AccountStakingInfo:
      type: object
      required:
        - pool
        - amount
        - pending_deposit
        - pending_withdraw
        - ready_withdraw
      properties:
        pool:
          type: string
          example: "EQBI-wGVp_x0VFEjd7m9cEUD3tJ_bnxMSp0Tb9qz757ATEAM"
        amount:
          type: integer
          format: int64
          example: 10050000000000
          x-js-format: bigint
        pending_deposit:
          type: integer
          format: int64
          example: 500000000000
          x-js-format: bigint
        pending_withdraw:
          type: integer
          format: int64
          example: 500000000000
          x-js-format: bigint
        ready_withdraw:
          type: integer
          format: int64
          example: 500000000000
          x-js-format: bigint
    PoolInfo:
      type: object
      required:
        - address
        - total_amount
        - implementation
        - apy
        - name
        - min_stake
        - cycle_start
        - cycle_end
        - verified
        - current_nominators
        - max_nominators
        - nominators_stake
        - validator_stake
      properties:
        address:
          type: string
          format: address
          example: "0:48fb0195a7fc7454512377b9bd704503ded27f6e7c4c4a9d136fdab3ef9ec04c"
        name:
          type: string
          example: "Tonkeeper pool"
        total_amount:
          type: integer
          format: int64
          x-js-format: bigint
        implementation:
          $ref: '#/components/schemas/PoolImplementationType'
        apy:
          type: number
          description: APY in percent
          example: 5.31
        min_stake:
          type: integer
          format: int64
          x-js-format: bigint
          example: 5000000000
        cycle_start:
          type: integer
          description: current nomination cycle beginning timestamp
          format: int64
          example: 1678223064
        cycle_end:
          type: integer
          description: current nomination cycle ending timestamp
          format: int64
          example: 1678223064
        verified:
          type: boolean
          example: true
          description: this pool has verified source code or managed by trusted company
        current_nominators:
          type: integer
          example: 10
          description: current number of nominators
        max_nominators:
          type: integer
          example: 100
          description: maximum number of nominators
        liquid_jetton_master:
          type: string
          format: address
          example: "0:4a91d32d0289bda9813ae00ff7640e6c38fdce76e4583dd6afc463b70c7d767c"
          description: "for liquid staking master account of jetton"
        nominators_stake:
          type: integer
          format: int64
          x-js-format: bigint
          example: 5000000000
          description: "total stake of all nominators"
        validator_stake:
          type: integer
          format: int64
          x-js-format: bigint
          example: 5000000000
          description: "stake of validator"
        cycle_length:
          type: integer
          format: int64
    PoolImplementation:
      type: object
      required:
        - name
        - description
        - url
        - socials
      properties:
        name:
          type: string
          example: TON Whales
        description:
          type: string
          example: "Oldest pool with minimal staking amount 50 Gram"
        url:
          type: string
          example: "https://tonvalidators.org/"
        socials:
          type: array
          items:
            type: string
            example: "https://t.me/tonwhales"
    StorageProvider:
      type: object
      required:
        - address
        - accept_new_contracts
        - rate_per_mb_day
        - max_span
        - minimal_file_size
        - maximal_file_size
      properties:
        address:
          type: string
          format: address
          example: 0:FD595F36B4C1535BEC8461490D38EBB9AE3C38DD6ACE17CA63ABE2C6608BE159
        accept_new_contracts:
          type: boolean
          example: true
        rate_per_mb_day:
          type: integer
          format: int64
          x-js-format: bigint
          example: 50000000
        max_span:
          type: integer
          format: int64
          example: 604800
        minimal_file_size:
          type: integer
          format: int64
          example: 64
        maximal_file_size:
          type: integer
          format: int64
          example: 10485760
    FoundAccounts:
      type: object
      required:
        - addresses
      properties:
        addresses:
          type: array
          items:
            type: object
            required:
              - address
              - name
              - preview
              - trust
            properties:
              address:
                type: string
                format: address
              name:
                type: string
                example: "blah_blah.ton"
              preview:
                type: string
                example: "https://cache.tonapi.io/images/media.jpg"
              trust:
                $ref: '#/components/schemas/TrustType'
    DnsExpiring:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          items:
            type: object
            required:
              - expiring_at
              - name
            properties:
              expiring_at:
                type: integer
                format: int64
                example: 1678275313
              name:
                type: string
                example: "blah_blah.ton"
              dns_item:
                $ref: '#/components/schemas/NftItem'
    ChartPoints:
      type: array
      items:
        type: array
        minItems: 2
        maxItems: 2
        items:
          type: number
      description: |
        Each inner array is a pair [timestamp, price]:
          • index 0 — Unix timestamp (int64)  
          • index 1 — token price (decimal) in the requested currency.
      example: [[1668436763, 97.21323234]]
    AccountInfoByStateInit:
      type: object
      required:
        - public_key
        - address
      properties:
        public_key:
          type: string
          example: "NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3..."
        address:
          type: string
          format: address
          example: "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b"
    Seqno:
      type: object
      required:
        - seqno
      properties:
        seqno:
          type: integer
          format: int32
    BlockRaw:
      type: object
      required:
        - workchain
        - shard
        - seqno
        - root_hash
        - file_hash
      properties:
        workchain:
          type: integer
          example: 4294967295
          format: int32
        shard:
          type: string
          # x-js-format: bigint ??
          example: "800000000000000"
        seqno:
          type: integer
          example: 30699640
          format: int32
        root_hash:
          type: string
          example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        file_hash:
          type: string
          example: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
    InitStateRaw:
      type: object
      required:
        - workchain
        - root_hash
        - file_hash
      properties:
        workchain:
          type: integer
          example: 4294967295
          format: int32
        root_hash:
          type: string
          example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
        file_hash:
          type: string
          example: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
    EncryptedComment:
      type: object
      required:
        - encryption_type
        - cipher_text
      properties:
        encryption_type:
          type: string
          example: "simple"
        cipher_text:
          type: string
          example: "A6A0BD6608672B...CE3AF8DB"
    BlockchainAccountInspect:
      type: object
      required:
        - code
        - code_hash
        - methods
        - compiler
      properties:
        code:
          type: string
          format: cell
        disassembled_code:
          type: string
        code_hash:
          type: string
        methods:
          type: array
          items:
            $ref: '#/components/schemas/Method'
        compiler:
          type: string
          enum:
            - func
            - fift
            - tact
            - tolk
        source:
          $ref: '#/components/schemas/Source'
    PoolImplementationType:
      type: string
      enum:
        - whales
        - tf
        - liquidTF
        - ffvault
        - hipo
    TokenRates:
      type: object
      properties:
        prices:
          type: object
          additionalProperties:
            type: number
          example:
            GRAM: 1.3710752873163712
        diff_24h:
          type: object
          additionalProperties:
            type: string
          example:
            GRAM: "-1.28%"
        diff_7d:
          type: object
          additionalProperties:
            type: string
          example:
            GRAM: "-2.74%"
        diff_30d:
          type: object
          additionalProperties:
            type: string
          example:
            GRAM: "-0.56%"
    MarketTonRates:
      type: object
      required:
        - market
        - usd_price
        - last_date_update
      properties:
        market:
          type: string
          example: "OKX"
        usd_price:
          type: number
          example: 5.20
        last_date_update:
          type: integer
          format: int64
          example: 1668436763
    ExtraCurrency:
      type: object
      required:
        - amount
        - preview
      properties:
        amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
        preview:
          $ref: '#/components/schemas/EcPreview'
    SourceFile:
      type: object
      required:
        - name
        - content
        - is_entrypoint
        - is_std_lib
        - include_in_command
      properties:
        name:
          type: string
        content:
          type: string
        is_entrypoint:
          type: boolean
          example: false
        is_std_lib:
          type: boolean
          example: false
        include_in_command:
          type: boolean
          example: false
    Source:
      type: object
      required:
        - files
      properties:
        files:
          type: array
          items:
            $ref: '#/components/schemas/SourceFile'
    Method:
      type: object
      required:
        - id
        - method
      properties:
        id:
          type: integer
          format: int64
        method:
          type: string
          example: "get_something"
    NftOperations:
      type: object
      required:
        - operations
      properties:
        operations:
          type: array
          items:
            $ref: '#/components/schemas/NftOperation'
        next_from:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
    NftOperation:
      type: object
      required:
        - operation
        - utime
        - lt
        - transaction_hash
        - item
      properties:
        operation:
          type: string
          example: "transfer"
        utime:
          type: integer
          format: int64
          example: 1234567890
        lt:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
        transaction_hash:
          type: string
          example: "0xdeadbeaf"
        source:
          $ref: '#/components/schemas/AccountAddress'
        destination:
          $ref: '#/components/schemas/AccountAddress'
        item:
          $ref: '#/components/schemas/NftItem'
    JettonOperations:
      type: object
      required:
        - operations
      properties:
        operations:
          type: array
          items:
            $ref: '#/components/schemas/JettonOperation'
        next_from:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
    JettonOperation:
      type: object
      required:
        - operation
        - utime
        - lt
        - jetton
        - transaction_hash
        - amount
        - trace_id
        - query_id
      properties:
        operation:
          type: string
          example: "transfer"
          enum: [ "transfer", "mint", "burn" ]
        utime:
          type: integer
          format: int64
          example: 1234567890
        lt:
          type: integer
          format: int64
          example: 25713146000001
          x-js-format: bigint
        transaction_hash:
          type: string
          example: "cbf3e3d70ecf6f69643dd430761cd6004de2cacbdbc3029b0abd30ca3cc1c67e"
        source:
          $ref: '#/components/schemas/AccountAddress'
        destination:
          $ref: '#/components/schemas/AccountAddress'
        owner:
          $ref: '#/components/schemas/AccountAddress'
          description: Owner of the jetton wallet the tokens were burned from; present when operation = burn.
        amount:
          type: string
          x-js-format: bigint
          example: "1000000000"
        jetton:
          $ref: '#/components/schemas/JettonPreview'
        trace_id:
          type: string
          example: "8fa19eec7bd6d00d0d76048cebe31e34082a859410c9fcf7d55ef4ff8f7fcb47"
        query_id:
          type: string
          example: "17286061481122318000"
          x-js-format: bigint
        payload: { } # free from json
    ExecGetMethodArgType:
      type: string
      description: |
        Data type of the argument value:
        - `nan`: Not-a-Number value
        - `null`: Null value
        - `tinyint`: Decimal integer (e.g., `100500`)
        - `int257`: 257-bit integer in hex format with 0x prefix (e.g., `0xfa01d78381ae32`)
        - `slice`: TON blockchain address (e.g., `0:6e731f2e...`)
        - `cell_boc_base64`: Base64-encoded cell BOC (Binary Object Code) (e.g., `te6ccgEBAQEAAgAAAA==`)
        - `slice_boc_hex`: Hex-encoded slice BOC (e.g., `b5ee9c72...`)
      enum:
        - "nan"
        - "null"
        - "tinyint"
        - "int257"
        - "slice"
        - "cell_boc_base64"
        - "slice_boc_hex"
      example: int257
    ExecGetMethodArg:
      type: object
      required:
        - type
        - value
      properties:
        type:
          $ref: '#/components/schemas/ExecGetMethodArgType'
        value:
          type: string
          description: String representation of the value according to the specified type
          example: "0xfa01d78381ae32"
    Protocol:
      type: object
      required:
        - name
      properties:
        name:
          type: string
          example: "Ethena"
        image:
          type: string
          example: https://cache.tonapi.io/images/jetton.jpg
    BlockInfo:
      type: object
      required: [seqno, time]
      properties:
        seqno:
          type: integer
          format: uint32
          description: Masterchain block sequence number.
          example: 57486221
        utime:
          type: integer
          format: int64
          example: 23814011000000
    RoundInfo:
      type: object
      required: [start, end, start_block, end_block]
      properties:
        start_utime:
          type: integer
          format: int64
          example: 23814011000000
        end_utime:
          type: integer
          format: int64
          example: 23814011000000
        start_block:
          type: integer
          format: uint32
          description: Masterchain block seqno at (or nearest to) validation round start.
          example: 57480000
        end_block:
          type: integer
          format: uint32
          description: Masterchain block seqno at (or nearest to) validation round end.
          example: 57546000
    ValidatorsResponse:
      type: object
      required:
        - response_time_ms
        - block
        - validation_round
        - election_id
        - elector_balance
        - total_stake
        - reward_per_block
        - validators
      properties:
        response_time_ms:
          type: integer
          format: int64
          description: Server-side response time in milliseconds.
          example: 12345
        block:
          $ref: "#/components/schemas/BlockInfo"
        validation_round:
          $ref: "#/components/schemas/RoundInfo"
        election_id:
          type: integer
          format: int64
          description: Current election ID (electAt timestamp).
          example: 1740053384
        prev_election_id:
          type: integer
          format: int64
          description: Election ID of the round immediately before this one.
          example: 1772486024
        next_election_id:
          type: integer
          format: int64
          description: >
            Election ID of the round immediately after this one.
            Omitted when the current round is not yet finished (next round not known).
          example: 1772658824
        elector_balance:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        total_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        reward_per_block:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        validators:
          type: array
          items:
            $ref: "#/components/schemas/ValidatorRewardEntry"
    ValidationRound:
      type: object
      required: [election_id, start, end, start_block, finished]
      properties:
        election_id:
          type: integer
          format: int64
          description: Election ID (electAt timestamp).
          example: 1740053384
        start_utime:
          type: integer
          format: int64
          example: 23814011000000
        end_utime:
          type: integer
          format: int64
          example: 23814011000000
        start_block:
          type: integer
          format: uint32
          description: Masterchain block seqno at (or nearest to) round start.
          example: 57480000
        end_block:
          type: integer
          format: uint32
          description: Masterchain block seqno at (or nearest to) round end. Omitted if round hasn't finished.
          example: 57546000
        prev_election_id:
          type: integer
          format: int64
          description: Election ID of the round immediately before this one.
          example: 1772486024
        next_election_id:
          type: integer
          format: int64
          description: >
            Election ID of the round immediately after this one.
            Omitted when this round is not yet finished (next round not known).
          example: 1772658824
        total_stake:
          type: integer
          description: Total stake locked in the round.
          format: int64
          example: 123456789
          x-js-format: bigint
        bonuses:
          type: integer
          description: Total rewards the elector pays for the round. Omitted if round hasn't finished.
          format: int64
          example: 123456789
          x-js-format: bigint
        finished:
          type: boolean
          description: Whether the validation round is complete.
          example: true
    ValidationRoundsResponse:
      type: object
      required: [response_time_ms, rounds]
      properties:
        response_time_ms:
          type: integer
          format: int64
          description: Server-side response time in milliseconds.
          example: 1234
        rounds:
          type: array
          items:
            $ref: "#/components/schemas/ValidationRound"
    NominatorRewardEntry:
      type: object
      required: [address, weight, reward, effective_stake, stake]
      properties:
        address:
          type: string
          description: Nominator's wallet address (bounceable, base64url).
          example: "EQAqR4RYauq7p3jqKGnD-eSYVDoOCak9g8ZsSNVHI9fevCzB"
        weight:
          type: number
          format: double
          description: Nominator's share of total nominators' deposit (0–1).
          example: 0.15
        reward:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        effective_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
    ValidatorRewardEntry:
      type: object
      required: [rank, public_key, effective_stake, weight, reward]
      properties:
        rank:
          type: integer
          description: Position sorted by effective stake (descending).
          example: 1
        public_key:
          type: string
          description: Validator's public key (hex-encoded Ed25519).
          example: "e33f0e53552f951e0a27c8e5a461a1bd65975af369a2c85a06e51f7fbb8ae667"
        effective_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        weight:
          type: number
          format: double
          description: Fraction of total effective stake (0–1).
          example: 0.004648
        reward:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        pool:
          type: string
          description: Pool smart contract address (bounceable, base64url).
          example: "Ef_bmCmMPsrHKOC4hV8foWBs2TEUAggQ1Wfe6EAqjrI3sGNI"
        pool_type:
          type: string
          description: Contract type detected by code hash.
          enum:
            - nominator-pool-v1.0
            - single-nominator-pool-v1.0
            - single-nominator-pool-v1.1
            - other
        owner_address:
          type: string
        validator_address:
          type: string
        validator_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        nominators_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        total_stake:
          type: integer
          description: >
            Total funds deposited by the pool: effective_stake + credit
            (leftover balance kept in the elector contract after election).
          format: int64
          example: 123456789
          x-js-format: bigint
        validator_reward_share:
          type: number
          format: double
          description: Fraction of staking rewards kept by the validator (0.3 = 30%).
          example: 0.3
        nominators_count:
          type: integer
          format: uint32
        nominators:
          type: array
          items:
            $ref: "#/components/schemas/NominatorRewardEntry"
    RoundRewardsResponse:
      type: object
      required:
        - response_time_ms
        - election_id
        - round_start
        - round_end
        - start_block
        - end_block
        - total_bonuses
        - total_stake
        - validators
      properties:
        response_time_ms:
          type: integer
          format: int64
          description: Server-side response time in milliseconds.
          example: 5432
        election_id:
          type: integer
          format: int64
          description: Election ID (electAt timestamp).
          example: 1740053384
        prev_election_id:
          type: integer
          format: int64
          description: Election ID of the round immediately before this one.
          example: 1772486024
        next_election_id:
          type: integer
          format: int64
          description: Election ID of the round immediately after this one.
          example: 1772658824
        round_start:
          type: string
          format: date-time
          description: Validation round start time.
        round_end:
          type: string
          format: date-time
          description: Validation round end time.
        start_block:
          type: integer
          format: uint32
          description: First masterchain block of the round.
        end_block:
          type: integer
          format: uint32
          description: Last masterchain block of the round.
        total_bonuses:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        total_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        validators:
          type: array
          items:
            $ref: "#/components/schemas/ValidatorRewardEntry"
        error:
          type: string
    RewardsStats:
      type: object
      required: [apy, total_stake]
      properties:
        apy:
          type: array
          description: Time series of APY values as [timestamp_ms, apy] pairs
          items:
            type: array
            items:
              type: number
              format: double
        total_stake:
          type: array
          description: Time series of total stake in Gram as [timestamp_ms, stake] pairs
          items:
            type: array
            items:
              type: number
              format: double
  responses:
    Error:
      description: Some error during request processing
      content:
        application/json:
          schema:
            type: object
            required:
              - error
            properties:
              error:
                type: string
              error_code:
                type: integer
                format: int64
              details:
                $ref: '#/components/schemas/InsufficientFunds'