Non-user Initiated Transactions

Webhook

POST

non-user-initiated-tx

This webhook notifies partners when a proxy voting event is available for a user who holds real stock assets.

Partners receive this notification to inform their users of an upcoming shareholder vote, including the voting URL and optional deadline.

Examples

With voting deadline

{
  "params": {
    "user_id": "1f020444-59fc-6ab8-b914-12a53b25f111",
    "asset_id": "1f020444-59fc-6ab8-b914-12a53b25f112",
    "voting_url": "https://example.com/prox-vote-url",
    "voting_deadline": "2025-06-20T08:55:14.119Z"
  }
}

Without voting deadline

{
  "params": {
    "user_id": "1f020444-59fc-6ab8-b914-12a53b25f111",
    "asset_id": "1f020444-59fc-6ab8-b914-12a53b25f112",
    "voting_url": "https://example.com/prox-vote-url",
    "voting_deadline": null
  }
}

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Return a 200, 201, 202 or 204 status to indicate that the data was received successfully

This response does not have a body.

Request Example

Shell

JavaScript

Java

curl --location 'https://your-api-server.com' \
--header 'X-BTS-Idempotency-Key;' \
--header 'Signature;' \
--header 'Content-Digest;' \
--header 'Date;' \
--header 'Content-Type: application/json' \
--data '{
    "params": {
        "id": "abcd1234-12ab-ab12-abcdef123456",
        "user_id": "abcd1234-12ab-ab12-abcdef123456",
        "asset_id": 1,
        "asset_amount": "0.46987983466586",
        "related_offer_id": "2e4c89ac-1290-426f-8de0-4c7b40b91d3a",
        "type": "metal_storage_fee",
        "direction": "incoming",
        "created_at": "2023-01-09T13:08:00Z"
    }
}'

Modified at 2026-10-30 12:43:08

Top-Up Success V2

Non-user Initiated Transactions V2

Non-user Initiated Transactions

Examples#

With voting deadline#

Without voting deadline#

Request

Responses

Examples

With voting deadline

Without voting deadline