PolychartService
Upsert Layer
Create or update a drawing layer using optimistic concurrency.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/v1/polychart/layers' \
--header 'Accept: */*' \
--header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
--header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
--header 'X-API-SIGNATURE: YOUR_API_SIGNATURE' \
--header 'Content-Type: application/json' \
--data '{
"expectedRevision": "1",
"layer": {
"colorRgba": 1,
"engineSymbolId": 1,
"isLocked": false,
"isVisible": false,
"layerId": "1",
"name": "BTC Support and Resistance",
"ownerId": "1",
"revision": "1",
"sortHint": 1,
"updatedAtMs": "1",
"useLayerColor": false
}
}'Responses
{
"layer": {
"colorRgba": 1,
"engineSymbolId": 1,
"isLocked": false,
"isVisible": false,
"layerId": "1",
"name": "BTC Support and Resistance",
"ownerId": "1",
"revision": "1",
"sortHint": 1,
"updatedAtMs": "1",
"useLayerColor": false
}
}Expected current layer revision; 0 creates a new layer.
Layer payload to create or update.
Account that owns the layer.
1Layer identifier unique within the owner account.
1Engine symbol identifier for the market this layer belongs to.
1Human-readable layer name.
BTC Support and ResistanceOwner-defined ordering hint for the layer list.
1Owner-level style defaults. Packed layer color in 0xAARRGGBB format.
1True when drawings should use the layer color by default.
falseTrue when clients should prevent editing drawings in this layer.
falseTrue when the layer is visible by default.
falseMonotonic per layer; increments on any committed change to the layer or its drawings.
1Server-assigned commit timestamp in milliseconds since epoch (UTC).
1| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |