Sign in
Earn

Get one external-wallet movement

Polls one recorded movement to a terminal state — the read that settles a submit whose outcome the caller never learned. Each poll observes the movement's exact signature on chain and advances the recorded status immediately, so state lands as fast as the network decides it; if the chain read is unavailable the last durable status is served and a background reconciler (about every minute) remains the recovery path. Keep polling until finalized or failed — those are the only terminal states.

get/v1/earn/external-wallet/movements/{movementId}

Path parameters

movementIdstring required

Headers

x-project-idstring

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Example:prj_example

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Response

Recorded movement

Example response

{
  "data": {
    "movement": {
      "movementId": "earn_movement_example",
      "positionId": "earn_position_example",
      "provider": "kamino",
      "providerReference": "7uib8xGAwkaPz4ZGCA6t8sSEid5Yp9ty13PHUweTypx",
      "ownerAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "amount": "25",
      "denomination": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "confirmedAt": "2025-01-01T00:00:00.000Z",
      "settledAt": "2025-01-01T00:00:00.000Z"
    }
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes

Changed in 1 of the 13 revisions of this API.1