Skip to main content
POST
/
v1beta1
/
create_position_change_subscription
Create Position Change Subscription
curl --request POST \
  --url https://traderapi.us-east-1.privatelink.preprod.polymarketexchange.com/api/v1beta1/create_position_change_subscription \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbols": [
    "aec-nfl-buf-nyj-2025-01-15"
  ]
}
'
{
  "position_changes": [
    {}
  ],
  "resume_token": "aSDinaTvuI8gbWludGxpZnk="
}

Body

application/json

Request to start a position update subscription.

​
firms
string[]

A list of firms by fully qualified resource name to filter upon. Optional.

​
symbols
string[]

A list of symbols to filter upon. Optional.

Example:
["aec-nfl-buf-nyj-2025-01-15"]
​
resume_token
string<byte>

Bookmark to resume the subscription if the stream must be restarted.

​
resume_time
string<date-time>

Timestamp from which to resume the subscription if the stream must be restarted.

Response

A successful response (streaming).

Subscription response containing position changes.

​
position_changes
object[]

Position change events found.

​
resume_token
string<byte>

A resume token that can be used to resume the stream upon a new connection.