Alpine· Docs
Contents

Guides

Track a transfer

Read status and history for any ref your key can see.

Any ref your key can read, you can follow. Status is where it stands now; the playground's track-a-ref watches it move.

  1. 01 · Read status

    The current stage of a transfer, from its ref.

    GET /v1/transfers/{transferRef}/status   → body.value.status

    A ref your key cannot read is refused, not invented — the answer is a plain problem, not a guess.

  2. 02 · Watch it settle

    Poll while the status is not terminal; stop when it reaches completed, or pauses at awaiting_finality, or fails. The playground does this for you: paste a ref into track-a-ref and it reads on an interval, honestly marking a still-moving transfer as paused rather than pretending it is done.

gateway 0.1.0 · sandbox