positions

Track a position you prepared

positionId is the strategyHash returned by POST /v1/positions — there is no second identifier to keep track of.

We only report what we have observed. prepared = nothing seen on-chain yet. shipped = the strategy is in the live catalogue, which means your wallet signed, broadcast and it was included. filled = it has settled volume.

Two states we deliberately do not report. There is no signed: a signature is unobservable before broadcast, and by then the position is shipped. There is no failed: we watch the catalogue, not every reverted transaction — your own receipt is the authority on that.

Timestamps are named firstSeen* because they record when we observed a state, not when it happened.

A key only ever sees positions it prepared itself. Another key's position and a non-existent one both return 404, deliberately indistinguishable.

get/v1/positions/{positionId}

Request

  • Base URL: https://yield.trdefi.com
  • URL: https://yield.trdefi.com/v1/positions/{positionId}
  • Auth: HTTP bearer

Path parameters

positionIdstring required

The strategyHash returned by POST /v1/positions.

Response

The observed lifecycle of your position

Example response

{
  "meta": {
    "apiVersion": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.