Observe positions
GEThttps://vega-data.nodes.guru:3008/api/v2/stream/positions
Subscribe to a stream of position updates. The first messages sent through the stream will contain information about current positions, followed by updates to those positions.
Request
Query Parameters
partyId string
Restrict position updates to those related to the given parties.
marketId string
Restrict position updates to those related to the given markets.
Responses
- 200
- 500
- default
A successful response.(streaming responses)
- application/json
- Schema
- Example (from schema)
Schema
error object
result object
{
"error": {
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
},
"result": {
"snapshot": {
"lastPage": true,
"positions": [
{
"averageEntryPrice": "string",
"lossSocialisationAmount": "string",
"marketId": "string",
"openVolume": "string",
"partyId": "string",
"positionStatus": "POSITION_STATUS_UNSPECIFIED",
"realisedPnl": "string",
"unrealisedPnl": "string",
"updatedAt": "string"
}
]
},
"updates": {
"positions": [
{
"averageEntryPrice": "string",
"lossSocialisationAmount": "string",
"marketId": "string",
"openVolume": "string",
"partyId": "string",
"positionStatus": "POSITION_STATUS_UNSPECIFIED",
"realisedPnl": "string",
"unrealisedPnl": "string",
"updatedAt": "string"
}
]
}
}
}
An internal server error
- application/json
- Schema
- Example (from schema)
Schema
code int32
details object[]
message string
{
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
}
An unexpected error response.
- application/json
- Schema
- Example (from schema)
Schema
code int32
details object[]
message string
{
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
}
- curl
- python
- go
- nodejs
- CURL
curl -L -X GET 'https://vega-data.nodes.guru:3008/api/v2/stream/positions' \
-H 'Accept: application/json'