GET
/
tryLocateTx
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/tryLocateTx
{
  "block": {
    "workchain": 123,
    "shard": "<string>",
    "seqno": 123,
    "root_hash": "<string>",
    "file_hash": "<string>"
  },
  "transaction_id": {
    "lt": "<string>",
    "hash": "<string>"
  }
}

The tryLocateTx method attempts to locate a specific transaction in the TON blockchain based on the source address, destination address, and the logical time when the transaction was created. This method is useful for finding detailed information about a transaction when you have partial information about it.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

​
Parameters

  • source (string, required) — The source address of the transaction. Example: UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1.
  • destination (string, required) — The destination address of the transaction. Example: UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA.
  • created_lt (string, required) — The logical time when the transaction was created. Example: 47597573000002.

​
JSON-RPC example

Shell
curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tryLocateTx",
    "params": {
      "source": "UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1",
      "destination": "UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA",
      "created_lt": "47597573000002"
    }
  }'

​
Response

  • block (object) — Information about the block containing the transaction:
    • workchain (integer) — The workchain ID of the block.
    • shard (string) — The shard ID of the block.
    • seqno (integer) — The sequence number of the block.
    • root_hash (string) — The root hash of the block.
    • file_hash (string) — The file hash of the block.
  • transaction_id (object) — The identifier of the transaction:
    • lt (string) — The logical time of the transaction.
    • hash (string) — The hash of the transaction.

​
Use case

A possible use case for the tryLocateTx method in TON is for blockchain explorers, wallet applications, or any service that needs to locate a specific transaction with partial information. This method can be used to:

  1. Find the full details of a transaction when only the source, destination, and approximate time are known.
  2. Verify the existence and details of a transaction in dispute resolution scenarios.
  3. Implement advanced search functionality in blockchain explorers.
  4. Cross-reference transactions across different data sources or systems.

Query Parameters

​
source
string
default:UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1
required

The source address of the transaction

​
destination
string
default:UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA
required

The destination address of the transaction

​
created_lt
string
default:47597573000002
required

The logical time when the transaction was created

Response

200 - application/json

Information about the located transaction

The response is of type object.