Subscribing to the premium updates provides real-time data for action costs and multipliers on the platform.
Action costs may change due to very high L1/L2 gas prices. Occasional minor fluctuations of the gas price will not affect the multiplier.
Premium action cost map contains prices for the single batch actions and specified in micro units: $1 = 1000000. Multiplier represents the difference between normal/minimal and current action costs. For example, if multiplier is 1, the prices are currently the lowest they can be on the platform. When the multiplier changes, the price will change too.
These values can change independently of one another. For example, cancelOrder might have multiplier of 1, while createOrder has multiplier of 11. Same applies to different base action types - meta_transaction (costs for actions performed with a meta-transaction) and trusted_transaction (costs for actions performed via trading API).
Parameters
with_snapshot: Whether to include the snapshot in the response. It may incur additional API credit spending.
{
"id": 1,
"jsonrpc": "2.0",
"method": "premium_updates.subscribe",
"params": {}
}
Snapshots
Upon subscription, current premium values and multipliers are provided.
{
"jsonrpc": "2.0",
"method": "premium_updates.snapshot",
"params": {
"data": {
"premium_action_cost": {
"meta_transaction": {
"cancelOrder": {
"price": "50000",
"multiplier": "1"
},
"updateOrder": {
"price": "50000",
"multiplier": "1"
},
...
},
"trusted_transaction": {
"cancelOrder": {
"price": "50000",
"multiplier": "1"
},
"updateOrder": {
"price": "50000",
"multiplier": "1"
},
...
}
}
}
}
}
Events
Subscribers receive real-time events whenever one of the multiplier changes.
{
"jsonrpc": "2.0",
"method": "premium_updates.event",
"params": {
"data": {
"premium_action_cost": {
"meta_transaction": {
"cancelOrder": {
"price": "50000",
"multiplier": "1"
},
"updateOrder": {
"price": "50000",
"multiplier": "1"
},
...
},
"trusted_transaction": {
"cancelOrder": {
"price": "50000",
"multiplier": "1"
},
"updateOrder": {
"price": "50000",
"multiplier": "1"
},
...
}
}
}
}
}