# HTTP API

## **Getting Started**

This documentation provides a comprehensive guide to using the TON HTTP API, including API endpoints, request and response formats, and error handling. Whether you're building a new application or integrating with an existing one, this documentation will help you get started with the TON HTTP API quickly and efficiently.

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getAddressInformation" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getExtendedAddressInformation" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getWalletInformation" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getTransactions" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getAddressBalance" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getAddressState" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/packAddress" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/unpackAddress" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getMasterchainInfo" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getMasterchainBlockSignatures" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getShardBlockProof" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getConsensusBlock" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/lookupBlock" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/shards" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getBlockTransactions" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getBlockHeader" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getConfigParam" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/getTokenData" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/tryLocateTx" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/tryLocateResultTx" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/tryLocateSourceTx" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/detectAddress" method="get" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/sendBoc" method="post" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/sendBocReturnHash" method="post" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/sendQuery" method="post" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/estimateFee" method="post" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/runGetMethod" method="post" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}

{% openapi src="<https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e>" path="/jsonRPC" method="post" %}
[ton\_http\_api.json](https://3946753200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ofbWCtvCf8VWwPLyyEW%2Fuploads%2FJGh9AEwvndMzzmAar3R4%2Fton_http_api.json?alt=media\&token=5e75b12a-55e4-4a0b-a1c9-752abb34b43e)
{% endopenapi %}