The Multisig API from TOP Group (The Open Platform) — 2 operation(s) for multisig.
openapi: 3.0.0
info:
title: REST api to TON blockchain explorer Accounts Multisig 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: Multisig
externalDocs:
description: Additional documentation
url: https://docs.tonconsole.com/tonapi/rest-api/multisig
paths:
/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'
components:
schemas:
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'
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'
JettonVerificationType:
type: string
enum:
- whitelist
- graylist
- blacklist
- none
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'
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:
type: string
score:
type: integer
format: int32
scaled_ui:
$ref: '#/components/schemas/ScaledUI'
description:
type: string
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
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
ImagePreview:
type: object
required:
- resolution
- url
properties:
resolution:
type: string
example: 100x100
url:
type: string
example: https://site.com/pic1.jpg
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'
CurrencyType:
type: string
example: jetton
enum:
- native
- extra_currency
- jetton
- fiat
TrustType:
type: string
example: whitelist
enum:
- whitelist
- graylist
- blacklist
- none
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.
'
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
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)
NftApprovedBy:
type: array
items:
type: string
example: getgems
enum:
- getgems
- tonkeeper
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
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'
parameters:
accountIDParameter:
in: path
name: account_id
required: true
description: account ID
schema:
type: string
format: address
example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621