TON Center Docs

Get messages

curl --request GET \
  --url https://toncenter.com/api/v3/messages

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://toncenter.com/api/v3/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://toncenter.com/api/v3/messages"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://toncenter.com/api/v3/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "address_book": {},
  "messages": [
    {
      "bounce": true,
      "bounced": true,
      "created_at": "0",
      "created_lt": "0",
      "destination": "<string>",
      "fwd_fee": "0",
      "hash": "<string>",
      "hash_norm": "<string>",
      "ihr_disabled": true,
      "ihr_fee": "0",
      "import_fee": "0",
      "in_msg_tx_hash": "<string>",
      "init_state": {
        "body": "<string>",
        "decoded": {
          "comment": "<string>",
          "type": "<string>"
        },
        "hash": "<string>"
      },
      "message_content": {
        "body": "<string>",
        "decoded": {
          "comment": "<string>",
          "type": "<string>"
        },
        "hash": "<string>"
      },
      "opcode": 123,
      "out_msg_tx_hash": "<string>",
      "source": "<string>",
      "value": "0",
      "value_extra_currencies": {}
    }
  ],
  "metadata": {}
}

{
  "code": 123,
  "error": "<string>"
}

GET

api

messages

Get messages

curl --request GET \
  --url https://toncenter.com/api/v3/messages

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://toncenter.com/api/v3/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://toncenter.com/api/v3/messages"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://toncenter.com/api/v3/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "address_book": {},
  "messages": [
    {
      "bounce": true,
      "bounced": true,
      "created_at": "0",
      "created_lt": "0",
      "destination": "<string>",
      "fwd_fee": "0",
      "hash": "<string>",
      "hash_norm": "<string>",
      "ihr_disabled": true,
      "ihr_fee": "0",
      "import_fee": "0",
      "in_msg_tx_hash": "<string>",
      "init_state": {
        "body": "<string>",
        "decoded": {
          "comment": "<string>",
          "type": "<string>"
        },
        "hash": "<string>"
      },
      "message_content": {
        "body": "<string>",
        "decoded": {
          "comment": "<string>",
          "type": "<string>"
        },
        "hash": "<string>"
      },
      "opcode": 123,
      "out_msg_tx_hash": "<string>",
      "source": "<string>",
      "value": "0",
      "value_extra_currencies": {}
    }
  ],
  "metadata": {}
}

{
  "code": 123,
  "error": "<string>"
}

Query Parameters

msg_hash

string[]

Message hash. Acceptable in hex, base64 and base64url forms.

body_hash

string

Hash of message body.

source

string

The source account address. Can be sent in hex, base64 or base64url form. Use value null to get external messages.

destination

string

The destination account address. Can be sent in hex, base64 or base64url form. Use value null to get log messages.

opcode

string

Opcode of message in hex or signed 32-bit decimal form.

start_utime

integer

Query messages with created_at >= start_utime.

Required range: x >= 0

end_utime

integer

Query messages with created_at >= start_utime.

Required range: x >= 0

start_lt

integer

Query messages with created_lt >= start_lt.

Required range: x >= 0

end_lt

integer

Query messages with created_lt <= end_lt.

Required range: x >= 0

direction

enum<string>

Direction of message.

Available options:

in,

out

exclude_externals

boolean

Exclude external messages.

only_externals

boolean

Return only external messages.

limit

integer

default:10

Limit number of queried rows. Use with offset to batch read.

Required range: 1 <= x <= 1000

offset

integer

default:0

Skip first N rows. Use with limit to batch read.

Required range: x >= 0

sort

enum<string>

default:desc

Sort transactions by lt.

Available options:

asc,

desc

Response

address_book

object

Show child attributes

messages

object[]

Show child attributes

metadata

object

Show child attributes

Accounts

Actions

Api/v2

Blockchain

DNS

Jettons

NFTs

Stats

Get messages

Query Parameters

Response