Details
POST
/v2.Address/Details
address — any form, .ton names allowed; get_methods — true to also list the get-methods the contract's code declares (default false).| Field | Meaning |
|---|---|
address | hex (raw), bounceable (EQ…), non_bounceable (UQ…) |
ton_balance | TON |
contract_balance | jetton balance when the address is a jetton wallet (decimals applied), else 0 |
status | active · uninit · frozen · nonexist |
address_type | how the input parsed: bounce · non_bounce · raw · domain |
contract_type | detected interfaces: wallet_v4r2, jetton_master, jetton_wallet, nft_item, dns_item, nft_sale_getgems_v4… |
content | contract-specific content (metadata, owner, collection…) |
known, known_source | a curated jetton or NFT collection (catalog · gifts · stonfi · manual) — airdropped scam jettons are not known |
label | the public label of the address — exchange, wallet service, bridge, project, scam … — from an openly licensed dataset, with its source and dates (AddressLabel, the fields as in Labels); absent when the address has none or the labels cannot be read. Independent of known |
get_methods | only with get_methods: true: {id, name} of every get-method the code's method dictionary declares, by id ascending (1…262143; recv_internal and the negative ids such as recv_external are left out), name where apiton knows it (seqno, get_wallet_data …, else absent). Empty when there is no code or its layout cannot be parsed (some compilers) — a method can still be called by name with RunGetMethod. Ordinary code costs no extra chain read; code kept in a library one library read, remembered by the server afterwards |
{"code":…,"message":…})| Code | When |
|---|---|
invalid_argument (400) | the address cannot be parsed, or the domain does not resolve |
unavailable (503) | the public TON liteservers could not serve the read — retry in a second or two |
Request
Body Params application/json