POST/monitor_txAuth required

Monitor USDT Transaction

Begin tracking a USDT transaction. Callbacks are sent to your store's endpoint whenever the transaction status changes.

Requires Bearer token authentication. Include Authorization: Bearer YOUR_API_KEY in the request header.

Request Body

txhashstringrequired

The transaction hash to monitor.

cryptostringrequired

The cryptocurrency used (USDT).

match_callbackstringrequired

String to match part of your store's callback URL. Used to identify the correct store when you have multiple.

testnetintegerrequired

Network. 0 = mainnet (Ethereum), 1 = Sepolia testnet.

Responses

statusinteger

Current status of the transaction. -1 = Reverted, 0 = Unconfirmed, 1 = 1 confirmation, 2 = 2 confirmations (final).

Fetch cryptocurrency price

GET /price

Get payment history

GET /v2/payments

txhashbody · stringrequired

The transaction hash to monitor.

cryptobody · stringrequired

The cryptocurrency used (USDT).

match_callbackbody · stringrequired

String to match part of your store's callback URL. Used to identify the correct store when you have multiple.

testnetbody · integerrequired

Network. `0` = mainnet (Ethereum), `1` = Sepolia testnet.

Response will appear here

Request

curl -X POST \
  "https://www.blockonomics.co/api/monitor_tx" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

const response = await fetch('https://www.blockonomics.co/api/monitor_tx', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})

const data = await response.json()
console.log(data)

import requests

headers = {
        "Authorization": "Bearer YOUR_API_KEY"
    }

response = requests.post(
    "https://www.blockonomics.co/api/monitor_tx",
    headers=headers
)

print(response.json())

Response

{
  "status": 0
}