Bind transfer to transaction

This endpoint links an existing transfer in BitOK with a specific blockchain transaction.

Use it when:

• You already have a transfer object created earlier
• But want to explicitly assign a known TX hash
• Or override an automatically detected blockchain transaction

---

HTTP Request

POST /v1/transfers/{id}/bind-transaction/

Where:

• {id} — the transfer ID (UUID)

---

Request body

{
  "tx_hash": "string",
  "network": "string"
}

Field descriptions

Field	Type	Required	Description
tx_hash	string	Yes	The blockchain transaction hash to bind.
network	string	Yes	Network code (e.g., ETH, BTC, TRX).

---

Example request

{
  "tx_hash": "0x4e3c6a2f5b6e8a9e4f2e4a57b7c0d18a21f77d57d516c66b9d6b9c3b9eac7e72",
  "network": "ETH"
}

---

Response

Returns the updated transfer object with the new transaction binding.

Example response

{
  "id": "d0f44f2c-b2e3-41b0-a74d-b4e0b7bdac35",
  "network": "ETH",
  "tx_hash": "0x4e3c6a2f5b6e8a9e4f2e4a57b7c0d18a21f77d57d516c66b9d6b9c3b9eac7e72",
  "amount": "1500.25",
  "token_symbol": "USDT",
  "occurred_at": "2025-04-15T12:44:31.712080+03:00",
  "risk_level": "medium",
  "risk_score": 55,
  "fiat_value": 1500.25,
  "fiat_currency": "USD"
}

---

Try it

POST/v1/transfers/{id}/bind-transaction/

API KEY ID

API KEY SECRET

Path params

id

Body (JSON)

{ "tx_hash": "0x4e3c6a2f5b6e8a9e4f2e4a57b7c0d18a21f77d57d516c66b9d6b9c3b9eac7e72", "network": "ETH" }

HTTP Request

Press "Send Request" to generate HTTP request.

HTTP …
{
  // Response will be shown here after the request.
}