📊 Schemas

Transaction

{
  "tx_id": "aa451147fe9bc4514ebc6adc58582eabd480c2869a649571a9262d2e95dae9cd",
  "block_number": 75784535,
  "block_timestamp": 1758013530000,
  "block_hash": "0000000004846157838ba929f5a582509c8bf4395cf47f8dff1acd9ce8eb9e57",
  "from": "TLWKepDBC8RZjAhtWyNqASyzgyVyHUuS7o",
  "to": "TJbUDLSLdiuh1TdZ5hUEKMuboJ3X41vwxG",
  "amount": "7975000000",
  "token_symbol": "USDT",
  "token_decimals": 6,
  "contract_type": "TriggerSmartContract",
  "fee": 345000,
  "result": "SUCCESS",
  "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "token_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "raw_data": {},
  "@timestamp": "2025-09-16T09:05:30Z"
}

🛠️ Properties

Name	Type	Required	Restrictions	Description
tx_id	string	false	none	Transaction ID (hash)
block_number	integer	false	none	Block number containing the transaction
block_timestamp	integer	false	none	Block timestamp in milliseconds
block_hash	string	false	none	Block hash containing the transaction
from	string	false	none	Sender address
to	string	false	none	Receiver address
amount	string	false	none	Transaction amount
token_symbol	string	false	none	Token symbol (TRX, USDT, etc.)
token_decimals	integer	false	none	Number of decimal places for the token
contract_type	string	false	none	Type of contract executed
fee	integer	false	none	Transaction fee in SUN
result	string	false	none	Transaction result status
contract_address	string¦null	false	none	Contract address (for TRC20 tokens)
token_address	string¦null	false	none	Token (TRC20) contract address (alias of contract_address)
raw_data	object	false	none	Raw transaction payload from blockchain/indexer
@timestamp	string	false	none	Indexing timestamp (ISO 8601)

Account

{
  "address": "TLWKepDBC8RZjAhtWyNqASyzgyVyHUuS7o",
  "balance": "100000000",
  "create_time": 1689321600000,
  "latest_operation_time": 1689321600000,
  "allowance": 0,
  "latest_withdraw_time": 0,
  "is_witness": false,
  "asset_issued_name": "",
  "free_net_usage": 0,
  "free_net_limit": 1500,
  "total_net_limit": 43200000000,
  "net_used": 0,
  "net_limit": 0
}

🛠️ Properties

Name	Type	Required	Restrictions	Description
address	string	false	none	Account address
balance	string	false	none	Account balance in SUN (1 TRX = 1,000,000 SUN)
create_time	integer	false	none	Account creation time in milliseconds
latest_operation_time	integer	false	none	Latest operation time in milliseconds
allowance	integer	false	none	Account allowance
latest_withdraw_time	integer	false	none	Latest withdraw time
is_witness	boolean	false	none	Whether the account is a witness
asset_issued_name	string	false	none	Name of issued asset
free_net_usage	integer	false	none	Free network bandwidth usage
free_net_limit	integer	false	none	Free network bandwidth limit
total_net_limit	integer	false	none	Total network bandwidth limit
net_used	integer	false	none	Network bandwidth used
net_limit	integer	false	none	Network bandwidth limit

Pagination

{
  "current_page": 1,
  "total_pages": 5,
  "total_transactions": 100,
  "per_page": 20,
  "has_more": true
}

🛠️ Properties

Name	Type	Required	Restrictions	Description
current_page	integer	false	none	none
total_pages	integer	false	none	none
total_transactions	integer	false	none	none
per_page	integer	false	none	none
has_more	boolean	false	none	none

Webhook

{
  "id": 1,
  "user_id": 10,
  "coin": "TRX",
  "webhook_url": "https://example.com/webhook",
  "addresses": [
    "TLWKepDBC8RZjAhtWyNqASyzgyVyHUuS7o"
  ],
  "is_active": true,
  "created_at": "2025-09-16T12:00:00Z",
  "updated_at": "2025-09-16T12:00:00Z"
}

🛠️ Properties

Name	Type	Required	Restrictions	Description
id	integer	false	none	none
user_id	integer	false	none	none
coin	string	false	none	none
webhook_url	string(uri)	false	none	none
addresses	[string]	false	none	none
is_active	boolean	false	none	none
created_at	string(date-time)	false	none	none
updated_at	string(date-time)	false	none	none

Enumerated Values

Property	Value
coin	TRX

WebhookCreateRequest

{
  "coin": "TRX",
  "webhook_url": "https://example.com/webhook",
  "addresses": [
    "TLWKepDBC8RZjAhtWyNqASyzgyVyHUuS7o"
  ],
  "is_active": true
}

🛠️ Properties

Name	Type	Required	Restrictions	Description
coin	string	true	none	Currency for which to trigger webhooks
webhook_url	string(uri)	true	none	Target URL to receive webhook POST requests
addresses	[string]	true	none	List of addresses to monitor
is_active	boolean	false	none	Whether the webhook is active

Enumerated Values

Property	Value
coin	TRX

WebhookUpdateRequest

{
  "coin": "TRX",
  "webhook_url": "https://example.com/webhook",
  "addresses": [
    "TLWKepDBC8RZjAhtWyNqASyzgyVyHUuS7o"
  ],
  "is_active": true
}

🛠️ Properties

Name	Type	Required	Restrictions	Description
coin	string	true	none	none
webhook_url	string(uri)	true	none	none
addresses	[string]	true	none	none
is_active	boolean	false	none	none

Enumerated Values

Property	Value
coin	TRX

WebhookEvent

{
  "event": "transaction_confirmed",
  "coin": "TRX",
  "transaction_id": "test_5f2c9a7d3b1",
  "from_address": "TLWKepDBC8RZjAhtWyNqASyzgyVyHUuS7o",
  "to_address": "TJbUDLSLdiuh1TdZ5hUEKMuboJ3X41vwxG",
  "amount": "1000000",
  "confirmations": 6,
  "block_height": 12345678,
  "timestamp": "2025-09-16T12:00:00Z",
  "test": true
}

Payload that the system posts to your webhook_url

🛠️ Properties

Name	Type	Required	Restrictions	Description
event	string	false	none	none
coin	string	false	none	none
transaction_id	string	false	none	none
from_address	string	false	none	none
to_address	string	false	none	none
amount	string	false	none	Amount in minimal units (SUN for TRX)
confirmations	integer	false	none	none
block_height	integer	false	none	none
timestamp	string(date-time)	false	none	none
test	boolean	false	none	Indicates test webhook payload