The Accounts API from TOP Group (The Open Platform) — 22 operation(s) for accounts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/top-group-accounts-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: REST api to TON blockchain explorer Accounts API
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
paths:
/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}/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/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/accounts/{account_id}/events/emulate:
post:
description: Emulate sending message to retrieve account-specific events
operationId: emulateMessageToAccountEvent
tags:
- 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'
components:
schemas:
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'
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'
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
ElectionsRecoverStakeAction:
type: object
required:
- amount
- staker
properties:
amount:
type: integer
format: int64
example: 1660050553
x-js-format: bigint
staker:
$ref: '#/components/schemas/AccountAddress'
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'
BuyXTRAction:
type: object
required:
- recipient
- amount
properties:
recipient:
$ref: '#/components/schemas/AccountAddress'
amount:
type: string
x-js-format: bigint
example: '123000000000'
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'
JettonAssetInfo:
type: object
required:
- token_type
- defi_provider
properties:
token_type:
$ref: '#/components/schemas/DefiAssetType'
type:
$ref: '#/components/schemas/DefiAssetType'
defi_provider:
$ref: '#/components/schemas/DefiProvider'
pool_assets:
$ref: '#/components/schemas/DefiLiquidPoolAssets'
PoolImplementationType:
type: string
enum:
- whales
- tf
- liquidTF
- ffvault
DomainNames:
type: object
required:
- domains
properties:
domains:
type: array
items:
type: string
example: vasya.ton
ExtraCurrency:
type: object
required:
- amount
- preview
properties:
amount:
type: string
x-js-format: bigint
example: '1000000000'
preview:
$ref: '#/components/schemas/EcPreview'
Multisigs:
type: object
required:
- multisigs
properties:
multisigs:
type: array
items:
$ref: '#/components/schemas/Multisig'
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'
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
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'
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'
AccountStatus:
type: string
example: active
enum:
- nonexist
- uninit
- active
- frozen
NftApprovedBy:
type: array
items:
type: string
example: getgems
enum:
- getgems
- tonkeeper
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
DepositTokenStakeAction:
type: object
required:
- staker
- protocol
properties:
staker:
$ref: '#/components/schemas/AccountAddress'
protocol:
$ref: '#/components/schemas/Protocol'
stake_meta:
$ref: '#/components/schemas/Price'
JettonBurnAction:
type: object
required:
- amount
- jetton
- sender
- senders_wallet
properties:
sender:
$ref: '#/components/schemas/AccountAddress'
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'
AddExtensionAction:
type: object
required:
- wallet
- extension
properties:
wallet:
$ref: '#/components/schemas/AccountAddress'
extension:
type: string
format: address
example: 0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365
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'
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'
CurrencyType:
type: string
example: jetton
enum:
- native
- extra_currency
- jetton
- fiat
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:
# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/top-group/refs/heads/main/openapi/top-group-accounts-api-openapi.yml