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

post

Header parameters

x-api-public-keystringOptional

Public API-key

x-api-signaturestringOptional

Signing the request body with a private API-key

Content-typestringOptional

Request content type

Example: application/json

Body

addressstringRequired

Address in the blockchain

Example: 0x788529118F2A28C60b9de2Ba0353f5EE4293e044

webhookUrlstringRequired

URL for notifications when a transaction arrives

Example: https://merchant.domain/webhooks/transaction

Responses

application/json

objectOptional

Successful response

post

HTTPcURLJavaScriptPython

POST /api-gateway/track-addresses/add-address HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "address": "0x788529118F2A28C60b9de2Ba0353f5EE4293e044",
  "webhookUrl": "https://merchant.domain/webhooks/transaction"
}

200Success

{
  "success": true,
  "response": {
    "id": "f797a2c6-45de-4171-9144-81ec88037a57",
    "networks": [
      "ethereum"
    ],
    "address": "0x788529118F2A28C60b9de2Ba0353f5EE4293e044",
    "webhookUrl": "https://merchant.domain/webhooks/transaction"
  }
}