Transactions tracking

To add a tracking address, you must specify the address itself and the URL for sending notifications about transactions. The address will be monitored on all available networks.

To update the notification URL, you must re-add the address with the new URL.

Notifications are sent once without being sent again.

Notification body

{
  "currency": "USDT",
  "network": "ethereum",
  "address": "0x000....",
  "amount": "12.44",
  "tx": "0x0000........"
}

Transactions tracking

POSThttps://ocp.onchainpay.io/api-gateway/track-addresses/add-address

Header parameters

Body

application/json

address*string

Address in the blockchain

webhookUrl*string

URL for notifications when a transaction arrives

Response

200

Body

application/json

success*boolean

Request success indicator

response*TrackedAddress (object)

Request

JavaScriptCurl

const response = await fetch('https://ocp.onchainpay.io/api-gateway/track-addresses/add-address', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "address": "0x788529118F2A28C60b9de2Ba0353f5EE4293e044",
      "webhookUrl": "https://merchant.domain/webhooks/transaction"
    }),
});
const data = await response.json();

Response

{
  "success": false,
  "response": {
    "id": "cf96faf4-a00d-45fe-b22c-6c92a71504df",
    "networks": [
      "ethereum"
    ],
    "address": "0x788529118F2A28C60b9de2Ba0353f5EE4293e044",
    "webhookUrl": "https://merchant.domain/webhooks/transaction"
  }
}