Blockchain

Endpoint Overview

Method	Endpoint	Description
GET	/v1/blockchain/networks	Lists all supported blockchain networks.
GET	/v1/blockchain/balance/{network}/{address}	Retrieves the balance of an address on a given blockchain network.
GET	/v1/blockchain/transactionstatus/{network}/{transactionId}	Retrieves the confirmation status of a transaction.
GET	/v1/blockchain/transactioninfo/{network}/{transactionId}	Provides detailed transaction information including fees, sender, receiver, and timestamp.

---

Retrieve Supported Networks

GET /v1/blockchain/networks

Purpose: Lists all supported blockchain networks, including their short identifiers, names, and native symbols.

Example Requests

GET /v1/blockchain/networks

Example Response

{
  "data": [
    {
      "network": "ERC20",
      "networkName": "Ethereum",
      "nativeContractAddress": "ETHEREUM",
      "nativeSymbol": "ETH"
    }
    //...
  ],
  "success": true,
  "timestamp": 1740651646093,
  "requestId": "4c4e31d8-bba3-49ed-a997-321c5c2c2a16",
  "message": ""
}

---

Retrieve Address Balance

GET /v1/blockchain/balance/{network}/{address}

Purpose: Queries the balance of a specific address on the specified blockchain network.
Note: You must provide at least one query parameter (symbol, tokenId, or contractAddress).

Path Parameters:

| Name | Type | Mandatory | Description | |----------------|--------|-----------| | network | string | Yes | Blockchain network identifier (e.g., "TRX"). | | address | string | Yes | Blockchain wallet address. |

Query Parameters:

Name	Type	Mandatory	Description
symbol	string	No*	Token symbol (e.g., "TRX").
tokenId	number	Mandatory*	Token ID (e.g., 825).
contractAddress	string	No	Contract address of the token.

Note: At least one query parameter (symbol, tokenId, or contractAddress) must be provided.

Example Requests

GET /v1/blockchain/balance/TRX/TBFNPitRKTbRxGYXZu?symbol=TRX

Example Response

{
  "data": {
    "network": "TRX",
    "name": "TRON",
    "symbol": "TRX",
    "balance": 142.922878,
    "tokenId": 1958
  },
  "success": true,
  "timestamp": 1740653173034,
  "requestId": "1847989f-dcba-42ef-942a-33b746c357e4",
  "message": ""
}

---

Retrieve Transaction Status

GET /v1/blockchain/transactionstatus/{network}/{transactionId}

Purpose: Checks the status of a specific transaction on the blockchain.
Possible Statuses: CONFIRMED, PROCESSING, FAILED, ERROR.

Path Parameters:

Name	Type	Mandatory	Description
network	string	Yes	Blockchain network identifier (e.g., "TRX").
transactionId	string	Yes	Unique transaction hash/ID on the blockchain.

Example Requests

GET /v1/blockchain/transactionstatus/TRX/57d952ed1741bfd7...

Example Response

{
  "data": "CONFIRMED", // Transaction status: CONFIRMED, PROCESSING, FAILED, or ERROR
  "success": true,
  "timestamp": 1740653267894,
  "requestId": "a38289ff-0e36-4fcd-9276-625fcad762e3",
  "message": ""
}

---

Retrieve Transaction Information

GET /v1/blockchain/transactioninfo/{network}/{transactionId}

Purpose: Provides detailed information about a transaction, including amount, fees, sender and receiver addresses, and confirmation status.

Path Parameters:

Name	Type	Mandatory	Description
network	string	Yes	Blockchain network identifier (e.g., "ERC20").
transactionId	string	Yes	Unique transaction hash/ID on the blockchain.

Example Requests

GET /v1/blockchain/transactioninfo/ERC20/0xd1a5294ebfe9ec7d713...

Example Response

{
  "data": {
    "blockchainId": "0xd1a5294ebfe9ec7d713e60706cc531294d12e8a3f0e39042d4a5c5f29dcfb5d6", // Transaction hash on blockchain
    "tokenSymbol": "ETH",        // Token involved in the transaction
    "timestamp": 1740633719,     // Unix timestamp of the transaction
    "amount": 0.07,              // Amount transferred
    "contractAddress": "ETHEREUM", // Token contract address or blockchain identifier
    "network": "ERC20",          // Blockchain network of the transaction
    "fee": 0.000027468975765,    // Transaction fee
    "feeSymbol": "ETH",          // Symbol of currency used for fees
    "fromAddress": "0xa902ab3c5bd69198066b1e895eafa85ae409282e", // Sender's blockchain address
    "toAddress": "0xd682ae66683b77d76a463bc1a16ebf5c5d7423a6",   // Receiver's blockchain address
    "status": "CONFIRMED"        // Current status (e.g., CONFIRMED, PENDING, FAILED)
  },
  "success": true,
  "timestamp": 1740653631483,
  "requestId": "7c63a938-18ce-4ef7-bdf5-cdc887009243",
  "message": ""
}

---

Tip:
To identify the correct contractAddress or tokenId, use:

• GET /v1/tokeninformation/{tokenId}
• GET /v1/tokeninformation/symbols/{symbol}