kojhliang / ton-api-v4

TON HTTP API v4

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

TON API v4

Scallable and CDN-friendly HTTP API for TON blockchain.

API Endpoints

There are two public endpoints for this API:

Selfhosting

Easiest way to selfhost is to use docker:

docker run -e TON_CONFIG=https://your-config-url -p 3000:3000 tonwhales/ton-api-v4:v38

Methods

Get latest block

GET /block/latest

Example

{
    "last": {
        "seqno": 20260051,
        "shard": "-9223372036854775808",
        "workchain": -1,
        "fileHash": "CMw5kuwsPMfJQZ6fvW9zy8xczZRxWMK8r+9KdmCB1dY=",
        "rootHash": "qZxhIvvQf6CWk7+UkrDWmtRJUIjPP2U4eNtZIkKGYlE="
    },
    "init": {
        "fileHash": "XplPz01CXAps5qeSWUtxcyBfdAo5zVb1N979KLSKD24=",
        "rootHash": "F6OpKZKqvqeFp6CQmFomXNMfMj2EnaUSOXN+Mh+wVWk="
    },
    "stateRootHash": "l0OsDfM1r/IkNNWYqVq6t6zyZVq/EDmp0QnYYm4QS74=",
    "now": 1651510746
}

Get full block

GET /block/<seqno>

Example

{
    "exist": true,
    "block": {
        "shards": [
            {
                "workchain": -1,
                "seqno": 20260051,
                "shard": "-9223372036854775808",
                "rootHash": "qZxhIvvQf6CWk7+UkrDWmtRJUIjPP2U4eNtZIkKGYlE=",
                "fileHash": "CMw5kuwsPMfJQZ6fvW9zy8xczZRxWMK8r+9KdmCB1dY=",
                "transactions": [
                    {
                        "account": "Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF",
                        "hash": "RPBPe+SrbhRyRgRj204HwdxQqVjF9xfSaAuQl6SEK6o=",
                        "lt": "27587556000001"
                    },
                    {
                        "account": "Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF",
                        "hash": "vG2nmHhygPkxoeUshbVsVgE9qlT5engZOaY1RAycJCk=",
                        "lt": "27587556000002"
                    },
                    {
                        "account": "Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW",
                        "hash": "K6p5MNc4ZsjuWaPhPqPjREKVM94nfaRyHbSD6fJjEIs=",
                        "lt": "27587556000001"
                    },
                    {
                        "account": "Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW",
                        "hash": "jmubebyKwuPkt75X14lDGo0SHU5iMwElkjSfNxXn6LA=",
                        "lt": "27587556000003"
                    },
                    {
                        "account": "Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn",
                        "hash": "oRMfmLqtFW2lWeeIZYaDLg8upQDC2baKvukyrJZmGd8=",
                        "lt": "27587556000003"
                    }
                ]
            },
            {
                "workchain": 0,
                "seqno": 25423451,
                "shard": "-9223372036854775808",
                "rootHash": "HYyaG45W0zRzirGyU761gPVyvymHG4GrN5mK28WUjD8=",
                "fileHash": "qNHn9kSd0Ey7sVcWKfewDiMnaVDZUuMBu6gm922vpPI=",
                "transactions": []
            }
        ]
    }
}

Get block by unix time

GET /block/utime/<unix time>

Example

{
    "exist": true,
    "block": {
        "shards": [
            {
                "workchain": -1,
                "seqno": 22208312,
                "shard": "-9223372036854775808",
                "rootHash": "yrIMmfStaS0sy40/FF7jrOMMhNDfl/LNQXFyikLN7Nc=",
                "fileHash": "G3xxsoHwwBhac1OOtB4N9XIyAe1HZhEcr2DUczD5zgo=",
                "transactions": [
                    {
                        "account": "Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF",
                        "hash": "Wi9oo1nEyfdi+aGKtM5Mp9i9NmmB+dk3Duad2QONCTs=",
                        "lt": "29722294000001"
                    },
                    {
                        "account": "Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF",
                        "hash": "FdJL1IXpJ1xh8sgOsCiX2QGSQM7nVMjF8haqnnfpPDs=",
                        "lt": "29722294000002"
                    },
                    {
                        "account": "Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW",
                        "hash": "4kLj1vN30ENzfhs0fmgIdgV5Q978Bm4seFcrdJ6xVxU=",
                        "lt": "29722294000001"
                    },
                    {
                        "account": "Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW",
                        "hash": "jwHRVGgnOCTbbyo5uT0S26xrlTYq5lebdb1IVEoR+GQ=",
                        "lt": "29722294000003"
                    },
                    {
                        "account": "Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn",
                        "hash": "1/AVsZDncnAbAug+J/L+0fzNIXccFBg1i0EbtciJJw4=",
                        "lt": "29722294000003"
                    }
                ]
            },
            {
                "workchain": 0,
                "seqno": 27501824,
                "shard": "-9223372036854775808",
                "rootHash": "R8HwI7HJMUSrHIoXmnIScYZqkrFeN7w1SIYAtdtCly8=",
                "fileHash": "IE/RTI/0o0ctUHnOmBpEUNyjP/q/cHX86rMFIjaIUmU=",
                "transactions": [
                    {
                        "account": "EQB5JdVF7RQMlE5amEK2kQ0DF8J7Ykpm_clPgnU19IjBY81O",
                        "hash": "736NHkWwCJ/lM/u4bE+FkapLAEy8fuDKFkOao/78oO8=",
                        "lt": "29722293000001"
                    },
                    {
                        "account": "EQB5JdVF7RQMlE5amEK2kQ0DF8J7Ykpm_clPgnU19IjBY81O",
                        "hash": "KNdrekbyAeTIhVdtTSrRBoRX6tHYRahvlMkSQ6hKCwc=",
                        "lt": "29722293000007"
                    },
                    {
                        "account": "EQCXxtncmR-OSh1CNtqYDOjm4toQyMcRIWkEQDY_FRLimGZ4",
                        "hash": "PrEPfMXjjIJ5J6Uuc8TF0g70qOn3Tp53W6Y314ztU08=",
                        "lt": "29722293000005"
                    },
                    {
                        "account": "EQDWHdEQ7hES-Gc0QxBAWTIZDgvCfoMprovccc4tV7f33keE",
                        "hash": "il4woJYyVpGGjL8unx6rg/83RSHg099mqANEKXrulbs=",
                        "lt": "29722293000003"
                    }
                ]
            }
        ]
    }
}

Get account state at block

GET /block/<seqno>/<address>

Example Active

{
    "account": {
        "state": {
            "type": "active",
            "code": "te6ccsEBAQEAcQAAAN7/ACDdIIIBTJe6IYIBM5y6sZ9xsO1E0NMf0x8x1wv/4wTgpPJggwjXGCDTH9Mf0x/4IxO78mPtRNDTH9Mf0//RUTK68qFRRLryogT5AVQQVfkQ8qP4AJMg10qW0wfUAvsA6NEBpMjLH8sfy//J7VTpzt1c",
            "data": "te6ccsEBAQEAKgAAAFAAAAA3KamjF3LJ7WtipuLroUqTuQRi56Nnd3vrijj7FbnzOETSLOL/41iLCA=="
        },
        "balance": {
            "coins": "68059884193787038"
        },
        "last": {
            "lt": "27585609000006",
            "hash": "TDhTOsz5TH9TNp5CdHjYtmzb/gA9gMrQA8jNRfutcKQ="
        }
    },
    "block": {
        "workchain": -1,
        "seqno": 20260051,
        "shard": "-9223372036854775808",
        "fileHash": "CMw5kuwsPMfJQZ6fvW9zy8xczZRxWMK8r+9KdmCB1dY=",
        "rootHash": "qZxhIvvQf6CWk7+UkrDWmtRJUIjPP2U4eNtZIkKGYlE="
    }
}

Example Uninitialized

{
    "account": {
        "state": {
            "type": "uninit"
        },
        "balance": {
            "coins": "0"
        },
        "last": null
    },
    "block": {
        "workchain": -1,
        "seqno": 100,
        "shard": "-9223372036854775808",
        "fileHash": "UrMFCxxozFopj02DXaCvACnUQixvMGXELsir2vcg8AI=",
        "rootHash": "bWveWwcLINRBhpmtkD6+KUQRS5IziVCvmVAjzHAta6Q="
    }
}

Example Frozen

{
    "account": {
        "state": {
            "type": "frozen",
            "stateHash": "wLZlv78I4AMOzvpwfAndGgnP4zjzgEgGztOHSxaktqI="
        },
        "balance": {
            "coins": "0"
        },
        "last": {
            "lt": "17307821000003",
            "hash": "iJctiNh0Mlerm3BINwbiHwXDLsGa3vQBbOwU7Yeh7JU="
        }
    },
    "block": {
        "workchain": -1,
        "seqno": 20260051,
        "shard": "-9223372036854775808",
        "fileHash": "CMw5kuwsPMfJQZ6fvW9zy8xczZRxWMK8r+9KdmCB1dY=",
        "rootHash": "qZxhIvvQf6CWk7+UkrDWmtRJUIjPP2U4eNtZIkKGYlE="
    }
}

Detect if account was changed

GET /block/<seqno>/<address>/changed/<since_lt>

Example

{"changed":true,"block":{"workchain":-1,"seqno":20435953,"shard":"-9223372036854775808","fileHash":"HFflk6uOnOpFc40freTDTPytu9z1zMsRTN6OjruZE/0=","rootHash":"jhnNLXgngcxKNLVsYcdfDZbmEcYAAW9FG1MQdbzv8kU="}}

Run get method of account at block

NOTE: To pass arguments you need to serialize them into url-safe base64 serialization of BOC with stack. You can find implementation in ton library.

GET /block/<seqno>/<address>/run/<method>/<args?>

Example

{
    "arguments": [],
    "result": [
        {
            "type": "int",
            "value": "55"
        }
    ],
    "exitCode": 0,
    "resultRaw": "te6ccgEBAgEAEQABGAAAAQEAAAAAAAAANwEAAA==",
    "block": {
        "workchain": -1,
        "seqno": 20260051,
        "shard": "-9223372036854775808",
        "rootHash": "qZxhIvvQf6CWk7+UkrDWmtRJUIjPP2U4eNtZIkKGYlE=",
        "fileHash": "CMw5kuwsPMfJQZ6fvW9zy8xczZRxWMK8r+9KdmCB1dY="
    },
    "shardBlock": {
        "workchain": 0,
        "seqno": 25423451,
        "shard": "-9223372036854775808",
        "rootHash": "HYyaG45W0zRzirGyU761gPVyvymHG4GrN5mK28WUjD8=",
        "fileHash": "qNHn9kSd0Ey7sVcWKfewDiMnaVDZUuMBu6gm922vpPI="
    }
}

Watch for new blocks

Open a WebSocket connection to /block/watch. And you will get notifications about current seqno, block time and server time. Server immediatelly sends current known block after opening a connection.

NOTE: This API doesn't guarantee that seqno always sequental. There are could be holes in sequences and apps have to adjust for them.

Example:

{"seqno":20259363,"time":1651508402,"now":1651508406}
{"seqno":20260395,"time":1651511942,"now":1651511946}
{"seqno":20260396,"time":1651511946,"now":1651511950}
{"seqno":20260397,"time":1651511949,"now":1651511953}
{"seqno":20260399,"time":1651511955,"now":1651511959}
{"seqno":20260400,"time":1651511958,"now":1651511962}
{"seqno":20260401,"time":1651511962,"now":1651511965}

Watch for new blocks (extended)

Open a WebSocket connection to /block/watch/changed to get stream of new blocks. This endpoint behaves same way as a previous one.

Example:

{"seqno":20260487,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588035000002","hash":"uK0OWZgfDlyJx1GjqmO2FHeAoQtsrgC9IF96FA++TNE="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588035000003","hash":"fGq3ttfz2ljePh61XLpzcUlgWFs+gkGxfKPjPJvGArE="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588035000003","hash":"pdzPDjQC9ADvXYBTxZvX65waohLgGIfiqGZBR2WUE4o="},"EQC3wzIebuX88AITT4AGQVakfrbx4dUb5Skoa0oc6Rnmwpoz":{"lt":"27588034000001","hash":"ph0Yh6JoYU5Cj+Gm7X5Rks4c6McqbbgGSu96xnnrrPw="},"EQDrLq-X6jKZNHAScgghh0h1iog3StK71zn8dcmrOj8jPWRA":{"lt":"27588034000003","hash":"Uzpg0OapY/r8h4AMHTkS2WqDLL4z7AA5t4buLfV2a38="}}}
{"seqno":20260488,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588036000002","hash":"INW1qjiGpFsZiLWRo41npGKFWXPleeNpeTQskIsjnJc="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588036000003","hash":"F6wc0Llhq4KKvqfD3PHIM/5n3ykTGm/OKdcGKC2+4Kg="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588036000003","hash":"BWSJtc6dUuPJCy5S9F8XGRAxDSnWrJwKGar0YhvcDY8="}}}
{"seqno":20260489,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588037000002","hash":"SubNyYvXMG4iG1JrxvNXc5cUZfBm3W5CtaXJNylvkdk="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588037000003","hash":"meOqQtrcCf81HMWgme28aPp05cWO118mqj0RZZBqwCM="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588037000003","hash":"WSN76pgVmS+ItpcbnUHiQqk+NyArFGD/VhSSYyWPKMU="}}}
{"seqno":20260490,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588038000002","hash":"8hT5jE7vOQ4ooCs5MA4UPJHdHJp08ysIp4Hsb2o3OX0="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588038000003","hash":"UK5COoq7o+K+oxzZahtHXzM92v3kdWYJLVLaeLk5o4A="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588038000003","hash":"nblGa391EjtncNsBoSH5xWXS/D/ALzYnmlC8FgRxc3w="},"EQAFF42xnDnvCXZ0JNK7xgZ-6RidwO7rf4W3mVOsaOBFd2ea":{"lt":"27588036000003","hash":"kOz8NIdvoKtzlMqa3wRJYfGtw79P5SoElM1c/eV5mY0="},"EQA1lcwRiOlPrJujNFck1KYYgpS-70nWAtZLqCunj0tXjhDJ":{"lt":"27588036000005","hash":"oR4mPUsXjP/0mwqO/VYtNtYiwmmXELmQT23HiwldcVQ="},"EQBDanbCeUqI4_v-xrnAN0_I2wRvEIaLg1Qg2ZN5c6Zl1KOh":{"lt":"27588036000003","hash":"fa4H63eKcRuQGti35MnmIbQUozmcRI2ZTG8H/N6N5t8="},"EQBN5uMyngPBKG2mwXmfqj3rZWP2tLMaY9NsmUOiJUZ3r9_f":{"lt":"27588036000001","hash":"8IWF2OaWF27URGRhga5HLpJVd9Q4dKhjZ4lnVf2CP6c="},"EQBUccbxLHChF_3Yl1VxSYJU5h38S2sYX7grFrcDi1UOXeu7":{"lt":"27588036000003","hash":"pW+QScxHMDtAPzN1PBcnYoZTY7OI0aIEIob7yPeQ8wM="},"EQBa-NEbYmfWu1gbPQON6s2gtcG8Z6Q5mi2oYWx1IY1bekCK":{"lt":"27588036000003","hash":"CyDDe6Ab8U/NbuXHIYJexihZT+kzX3hdRmbmarbOpIA="},"EQBlxuPNk1LAWg2tktudUAJvL7jZWp0IWJDqB5lMelU-xzu9":{"lt":"27588036000001","hash":"h5lAJ/nVf0WdSijAZGndlmVBsYpdOpCYIokrjkvUsfQ="},"EQBn0wArMG2k5uDGk6hZsMtv-ogChPfF7yzyzyh-TLSpOMsg":{"lt":"27588036000001","hash":"kM5sQldk3Ib5Ys4CoM72rRmcWE42ZdkVtVQQLzT0ruU="},"EQBvcjShYaVDj3QIhnv3BN97IJV0Q0X-fuSg4HZEmISQwcpO":{"lt":"27588036000006","hash":"6yp2ffuLqQGYx5TVIe8DgUh1v2x8OIbU8xTOdFrM1ws="},"EQB3NnZ_L_kLkCtlBx4w4ITBKIKtr-jVlGjIVAXHhVBQVML-":{"lt":"27588036000003","hash":"lRQaH98Q4grr3W7eLalO4YsaVRV4D4Hw6+Ao0eA0wS0="},"EQCCKNoS1XnCdcEZEyVPUdQVvtCAe9ppdkUmtm0z7FxUXvkB":{"lt":"27588036000008","hash":"7FWMuU2HQN9YZpb/m4KNSPiXWIbiEiXNluNctzjf29w="},"EQCtiv7PrMJImWiF2L5oJCgPnzp-VML2CAt5cbn1VsKAxLiE":{"lt":"27588036000003","hash":"Xgq55cjcGmBpBZF7/wRO8KzX/6vua+zDgtFTYRJW9LY="},"EQC5tigLelfMufxDkQFrO4OZotIcwxcuUXaBFwcGBfewX49f":{"lt":"27588036000006","hash":"Uw90oPpa0kB6HU71uHWB6UTKqSTRzigyCi1jvAaWkwA="},"EQDQA68_iHZrDEdkqjJpXcVqEM3qQC9u0w4nAhYJ4Ddsjttc":{"lt":"27588036000001","hash":"XwnOm0pTOEBNg8f1eYLITpjG2yryLQQ64OxLpzogKjA="},"EQDfTFLMMy0o3bY-XVFWik4oB6OM8SOZa2OiVQAH1q6M_oeu":{"lt":"27588036000004","hash":"welGkaY+SRNZtOnJkFc8eht1YZ0KAvNrJ844nheQhlQ="},"EQDrLq-X6jKZNHAScgghh0h1iog3StK71zn8dcmrOj8jPWRA":{"lt":"27588036000003","hash":"5ggcXhxzsuDRm87w2mqgOHZs3bj0HCfLhwvgmkUlNjk="},"EQDrhdkGkFZ87deKOyIKncFWgbz7IXhguDZLLygs5BXtJ_y-":{"lt":"27588036000001","hash":"88nJ9qn+xzbVyrf7NbJeB+JRhW2jy8fX3jNt35/+EWE="},"EQD3NgtHffdDblhnu3gpLPbhj3tZ_ZBwp4IdSv_ARPai_0sl":{"lt":"27588036000001","hash":"dBuUtZ6+Igbm/b9hhXXmsVqz3+SOxUJtRf5DjZv70+s="}}}
{"seqno":20260491,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588039000002","hash":"BcCpJ0To1e6YiGJRsHnA+Qpfq58ks7pg3d0uPIB4AcY="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588039000003","hash":"8n7rX2VaNnW4UsRRFBok7AQyrf24mEtb+PzLBkQiXjY="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588039000003","hash":"9PExWirQyYzzJaQj9j69jgq2+oZ4bCP7U8vuTphb7+c="}}}
{"seqno":20260492,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588040000002","hash":"HGdrMTzrdqyL7LXnGrPlLxIfymWs4dhLb7fpjPgh7qM="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588040000003","hash":"KgIRLbFQnJ0HhF1jDYEBU/Sp778/NsaQe2Vy0AKlIAs="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588040000003","hash":"hWrbeaY2YFyCb+cm0M+jSA6AEAaTH0TayH9puiE2DHQ="},"EQDfvQHYI4CGsxyuI1Qcm6A1fh4iwruuOcELzxgDbj5pketG":{"lt":"27588038000003","hash":"PnzkREgLPOtq1281SRN8Mpg6xF2nwTQtDOuHNGNUjqs="}}}
{"seqno":20260494,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588042000002","hash":"bKjjFD/Z5+K3NzasYXzyp2ccXqaB8GWwnTsxWQEsbYk="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588042000003","hash":"qDDNXjwTgfCKy+MWn28s6YMYLBRr/xM/7pZXOWzlQr0="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588042000003","hash":"kwlNVBh5gWnM1mhIc+gOwhtWXsNyfdRZq7VIWEmzdS8="}}}
{"seqno":20260495,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588043000002","hash":"7SSnYs5mP01dtBmJBQ2cUFb5B84Ezh0CzkNfEg3aCuM="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588043000003","hash":"ZaER9bVafOlTjbgWZcnCg6Lif/b/kmNAswcNlYiQX7U="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588043000003","hash":"4rscgwRFJTAWyfk5D7tTiJEYLn0fIBbRw2VF0bUHaNs="}}}
{"seqno":20260496,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588044000002","hash":"H1U+CEnt4+NpB/9u8eYbmm0Lkb60yBjKKodRWSchkGE="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588044000003","hash":"Su7Od4+8Sv1cDAp2M3rKrZeohs54DyJJBR+oi9a0ORE="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588044000003","hash":"C8LqzAylvRcgcDM2XSzjK184E6K4A+iWen/Rr+FWwGc="},"EQA0KjWeODV8CDloEp_d3fBJ71xHMVv77ydQWjVr-fAtZSqw":{"lt":"27588042000003","hash":"SaBFNIuJPd6yzgrd1mAAZvEB9T9Oz6pzC1Szor2ygz8="},"EQBeNwQShukLyOWjKWZ0Oxoe5U3ET-ApQIWYeC4VLZ4tmeTm":{"lt":"27588042000001","hash":"f6wuwC+11lk1SOhNps+Ozs5DBGGnec10KGS8cxrWCTE="},"EQCUp88072pLUGNQCXXXDFJM3C5v9GXTjV7ou33Mj3r0Xv2W":{"lt":"27588042000001","hash":"4XYgZfXTpaMG1wIOJxtdJ9ppN6VxsYc3ds5ugJkgPjE="},"EQCivzg-xbI_ikSpUnq7iGQzegtkICMkn7OGVYQ7iyRNCiO_":{"lt":"27588042000001","hash":"pV5ycxFQ8j6T+inJ79I+p/tBZLpB7AU1nbuvmp3zqqE="},"EQCtgLZ2238RcjJVhEc6S2JoMq7sDmoedeb6jlssRHyArJHN":{"lt":"27588042000003","hash":"JdfmRxTqYvRRHwXjXYR79W7SGDBQtkEyio2IDIOWlRc="},"EQCtiv7PrMJImWiF2L5oJCgPnzp-VML2CAt5cbn1VsKAxLiE":{"lt":"27588042000003","hash":"hCf9etb06IPNBJj94V8AjsYfqJdJt++GkFU1DYxZCj0="},"EQC2e_Xjk_Zbn3gaHE8XowZHiuYeblACscizzEjsz6NaxeLT":{"lt":"27588042000001","hash":"+faoYnP5v2mqk2vqoR0fFaxBE8Gi3VfV7wRJ85tjnDU="},"EQDouzETZs74Sa_yXw05Y2w06laJp09AbE5JmbvbvUkiqwA6":{"lt":"27588042000001","hash":"OgKK44OaFpzopf1aL8RlfhhvdMp85hoNEeuXM/FCpuo="},"EQDrLq-X6jKZNHAScgghh0h1iog3StK71zn8dcmrOj8jPWRA":{"lt":"27588042000003","hash":"JViwBfjbhCIGm1UcPKTAfY5B3T7RDDiLifvXDTrR0Oc="}}}
{"seqno":20260497,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588045000002","hash":"Yegb//2/lzudi29He1BdOMASKHuDkAKlsPqCw1sNyR8="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588045000003","hash":"DcPIJwF4yOsnRVtS2A041yvjvvkaedJKDI3mmkcxoZ4="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588045000003","hash":"g8rh0c7vtG9wUDy1qvdIvwntjALgFlTm0cbbO3KNvPg="},"EQAOSF47QREN1wTqzcizWTO6oTgxIDqi2j5nXzr7Cui3FdGC":{"lt":"27588043000003","hash":"MHkOusQf29W5sJwR1YQy5jJlCpZayJooO79PVXOATHc="},"EQA6Rtiz7YMa2Btit5xSDsoZgX9Op0DSub2w-CMbZCFz_zt-":{"lt":"27588043000003","hash":"sZ4do6V7bJHjQtYzFhgmQfOPuL6UGYN5bKYGXmcEDyw="},"EQCEzNIdBgRj_Io8ls7xaWl0DKOwlf2rAzLghh8c5iK_3VM6":{"lt":"27588043000001","hash":"Gai9ljjUpEy70MigLOGiCGfADYzUlRW6fHoa/iUnpmg="},"EQCtiv7PrMJImWiF2L5oJCgPnzp-VML2CAt5cbn1VsKAxLiE":{"lt":"27588043000001","hash":"9hVaXHRXqLFXUo+0R4ko/dl3bz5tTph7LdrJn4thFhU="},"EQDFcABC5c3mMf7EbNubeeM46cO0g6uK93ge6YCSI9HX1k5b":{"lt":"27588043000005","hash":"xcNCp/YBlAlO9xwUDKsVHIaHwWQVekgD9syyuJKjs+M="}}}
{"seqno":20260498,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588046000002","hash":"x6TW6oiRhCYUfmTairxhHptHa6tHOCCoh6Dl6woumaU="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588046000003","hash":"DJ5eDuHw59LAk9HcmPbWFKWPlVxrUvLqksF3WiUE00Y="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588046000003","hash":"PYNfyqG9wLnIfFrZGSA/UvKJZxr2+x2Xm6zQnIt5e/U="},"EQA0KjWeODV8CDloEp_d3fBJ71xHMVv77ydQWjVr-fAtZSqw":{"lt":"27588044000003","hash":"8oB62hcro+nk7XdekMoB87VkxR3WoYJwHjRf16QFGzk="},"EQA836_0q_n1J_6InI-QB3hpMd917FuDPPiac43MA9gWYPNM":{"lt":"27588044000001","hash":"GC8a0SwP53+vyZ+tIs31QKG7nxERUY+C6ensUTvPw6Q="},"EQBN5uMyngPBKG2mwXmfqj3rZWP2tLMaY9NsmUOiJUZ3r9_f":{"lt":"27588044000001","hash":"WOxTwL0PS/ZcoTpfaOVrSNPG3caFqAHPUFDimXg98uo="},"EQBzdoz4j-vc9rZaQUSacV6yNlzQOT3ZYB7I8_gwbVoApL3x":{"lt":"27588044000004","hash":"12nUFBpQfqdIzjH9NHQudBKbgqmLDP1XpXDxKkYDzEA="},"EQCPJkrPrDrL7FF3D_Se2WTgZA1fotPmwTRU0a6oAWISvlgb":{"lt":"27588044000003","hash":"pP7nJkkN4KuuuYxVmT/zGMRMuNlLwtamH6JVZQ3LnMU="},"EQC2vq5V2B0TcG4Yy4LqmObeVKsFnVPJ8XH58DLao_tgeUyI":{"lt":"27588044000001","hash":"B2xM+LwVqqO7UUo1YQGATwQ4ImUkI6CtpxQ2lLljJ2I="},"EQDrjFWWME_-HCRCB8NpBBrRhckohoSpi07Ih5O-KWZjLofZ":{"lt":"27588044000003","hash":"uzscD2DRzBo7pWItDShQNwSlGkJUFkYAUqn4AoFhnyQ="}}}
{"seqno":20260499,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588047000002","hash":"faP2eIUHUxR5uxv5c0WfxyRtRUcB+32y/PGqrYmQKyE="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588047000003","hash":"Zn5OqJ/Q6uMEOmAWTgPm6eIj8liCaWYLyeYToqrCcrw="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588047000003","hash":"NoBWHBdEkVkvZq3cEZ76FKjpvIHGvqSkniFxJl8ZMNY="}}}
{"seqno":20260500,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588048000002","hash":"4ZO6zi77D5hIZ891u6JZU/qdTvK1PujcnL/zrjG5JD0="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588048000003","hash":"3pM7xSeB9EBJ5vl44oH7eWttsdECFTvRTZtaG9qoIhU="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588048000003","hash":"BmlYRXCHeFBqqwv2LyvCNgp/vsAqqc+MCLSDIXXfPJk="}}}
{"seqno":20260501,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588049000002","hash":"i6nR8lqWJIfLHP0e5WQYbVBS+8fEsBx04XFsWVnFoKM="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588049000003","hash":"qb1LNSY4wg7E7IbCeHICzfdMkv0pwGAtsrFrnQxjrsw="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588049000003","hash":"VRq8cy8GnbNV5N6JUd8azFcdwrT0JYlAhBmo2NOmInc="},"EQCtiv7PrMJImWiF2L5oJCgPnzp-VML2CAt5cbn1VsKAxLiE":{"lt":"27588047000001","hash":"gz+a51hfE5XbtFvL8BFtX6q64XYDVrw6w2Qh0VT8OjM="},"EQDtS0EPqLKA06kzJG3LzldZ8taNBLnceXZLpar8QsAE-lWn":{"lt":"27588047000003","hash":"tVNm6wMSfKLr+fWaVTNweW8vY2b2cXH2n5hYg63coFk="}}}
{"seqno":20260502,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588050000002","hash":"NR8u5tkKZtN+SNVHeXYH1o56rJD2q0eD8W2f4fLR3pI="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588050000003","hash":"QxhNkVByJ8wQf5NNSrb42u9wzfih1GEULDIbsAAEx7U="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588050000003","hash":"3RrFGqI3smj6FHsf+FYCyROQUuw2Cq/esg51RwV1Gck="}}}
{"seqno":20260503,"changed":{"Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF":{"lt":"27588051000002","hash":"jw2njtwbmMpg6ceUNGCNJ6Ru/ZMBFesv8gg86P5pW3Q="},"Ef80UXx731GHxVr0-LYf3DIViMerdo3uJLAG3ykQZFjXz2kW":{"lt":"27588051000003","hash":"pESWozJgTp2TyMMJRQtiqtGRIfPsY79EchCKVOxTPBc="},"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn":{"lt":"27588051000003","hash":"gddKcouSNPYD5/z/W5egrkXiI/uCc3RnN0cyhigfyTc="}}}

Get config at block

GET /block/<seqno>/config/:ids

NOTE: you need to manually parse cell into dict with 32 bit integer keys.

Example

{"exist":true,"config":{"cell":"te6cckEBBQEAUgACA87AAwEBAdQCAEDqw5GhWtBlRHAkrnTVXrXmH4t/zkj2ju9ZgbB+zEwJSgEBZgQAQDMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzPLrCaQ==","address":"Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn","globalBalance":{"coins":"5059853249096870767"}}}

Get account transactions

GET /account/<address>/tx/:lt/:hash

NOTE: This method always returns at most 20 results. Example

{"blocks":[{"workchain":0,"shard":"-9223372036854775808","seqno":25502350,"fileHash":"Z3nAkOC16+HVk8fFCeQEBMgdud7cWgBpAiELMf7yE6E=","rootHash":"LHxxzka0ijhFDBtCzcY++RXhfk5ss7QXUSh3YXA2E84="}],"boc": "te6ccgICAQgAEAAALCgADwAOAA0ADAALAAoACQAIAAcABgAFAAQAAwACAAE.....inN/zJIAeKAjN2zBN0h86GSts5pd6jN9mIEnrkQFAWjA=="}

License

MIT

About

TON HTTP API v4

License:MIT License


Languages

Language:TypeScript 99.3%Language:Dockerfile 0.4%Language:JavaScript 0.2%Language:Shell 0.1%