Your settled positions and closed offers

get/forwards/historyapi_key

Every position this wallet held a side of that has been settled or refunded, with what it received and its net after margins and rewards, and every offer it made that was filled or cancelled. Newest first, at most 200 of each. A settlement still unconfirmed appears once it confirms.

Responses

200This wallet's historyDFHistory▶

heightinteger · int32required
▶
settledDFSettledView[]required
- boxIdstringrequired
- sidestringrequired
  one oflongshortboth
- strikestringrequired
- notionalstringrequired
- marginstringrequired
- windowStartinteger · int32required
- windowLengthinteger · int32required
- windowEndinteger · int32required
- txIdstringrequired
  The settlement transaction.
- settledHeightinteger · int32required
- settledAtinteger · int64required
  Unix milliseconds of the block that confirmed the settlement.
- refundbooleanrequired
  Whether each side got its margin back because the window had left the accumulator.
- windowMeanstring
  The window's mean difficulty as the settlement read it. Absent for a refund.
- payoutstringrequired
  LIT base units the long side received on top of its margin, negative when the short side was paid.
- receivedstringrequired
  LIT base units this wallet's side or sides received, margins included.
- netstringrequired
  received less what this wallet put in: each side's margin and its 7.5 LIT of rewards.
▶
offersDFPastOffer[]required
- boxIdstringrequired
- makerSidestringrequired
  one oflongshort
- strikestringrequired
- notionalstringrequired
- windowStartinteger · int32required
- windowLengthinteger · int32required
- expiryinteger · int32required
- outcomestringrequired
  one offilledcancelled
- txIdstringrequired
  The transaction that filled or cancelled it.
- heightinteger · int32required
- timestampinteger · int64required
- positionBoxIdstring
  The position a fill created.
realizedNetstringrequired
The sum of every settled position's net, in LIT base units.
winsintegerrequired
Settled positions with a positive net.
lossesintegerrequired
Settled positions with a negative net.
truncatedbooleanrequired
Whether a scan stopped at its cap, so older history may be missing.

403Missing or wrong api_keyApiError▶

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

503Node or index unavailable. Never returns a partial list.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

← PreviousThe whole market Next →List your positions and offers

{ "height": 0, "settled": [ { "boxId": "string", "side": "long", "strike": "string", "notional": "string", "margin": "string", "windowStart": 0, "windowLength": 0, "windowEnd": 0, "txId": "string", "settledHeight": 0, "settledAt": 0, "refund": true, "windowMean": "string", "payout": "string", "received": "string", "net": "string" } ], "offers": [ { "boxId": "string", "makerSide": "long", "strike": "string", "notional": "string", "windowStart": 0, "windowLength": 0, "expiry": 0, "outcome": "filled", "txId": "string", "height": 0, "timestamp": 0, "positionBoxId": "string" } ], "realizedNet": "string", "wins": 0, "losses": 0, "truncated": true }