Proxy Voting Notifications

Webhook

POST

proxy-voting

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": {
        "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"
    }
}'

Modified at 2026-06-01 11:50:47

Automated Orders Notifications

Overview

Proxy Voting Notifications

Examples#

With voting deadline#

Without voting deadline#

Request

Responses

Examples

With voting deadline

Without voting deadline