Fee history for one provision

get/dex/provisions/{boxId}/fees/history

Earnings over time for one provision, from its current size and entry. Earnings from before a resize are not reconstructed.

Path parameters

boxIdstringrequired
UTXO id of the provision box

Query parameters

frominteger · int32
First block height to include
tointeger · int32
Last block height to include
bucketinteger · int32default 720
Bucket size in blocks

Responses

200Bucketed fee history for the provisionLDProvisionFeeHistory▶

boxIdstringrequired
▶
historyLDFeeHistoryPoint[]required
- heightinteger · int32required
  Block height at the end of this bucket
- timestampinteger · int64
  Unix milliseconds at the end of this bucket. Absent if unresolved.
- periodXstringrequired
  nanoERG fees taken during this bucket. Decimal string.
- periodYstringrequired
- cumulativeXstringrequired
  nanoERG fees taken from the start of the range to here. Decimal string.
- cumulativeYstringrequired
partialbooleanrequired
True when the series does not reach back to the pool's start.

400No pool history indexed, or an invalid range or bucket size.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

404No live provision with that id.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

409The provision moved. Re-read to find its current box id.LDStateChangedResponse▶

errorintegerrequired
reasonstringrequired
detailstringrequired
What moved, and what it moved to
poolBoxIdstring
Current pool box id
vaultBoxIdstring
Current vault box id
provisionBoxIdstring
Current provision box id

503Node unavailable. Retry.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

defaultErrorApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

← PreviousRecent pool activity Next →Wallet balances and lending status

Request

curl -X GET "http://localhost:9000/dex/provisions/{boxId}/fees/history"

Response

{
  "boxId": "ce00d6e0f4fd3390c0519bb0d24824e1e6b06978163f4845a7cf2c1c7d8f1b65",
  "history": [
    {
      "height": 1312460,
      "timestamp": 1765432100000,
      "periodX": "210000000",
      "periodY": "6350000",
      "cumulativeX": "8420000000",
      "cumulativeY": "254300000"
    }
  ],
  "partial": false
}