Earn

List one external wallet's activity

Returns one keyset page of the wallet's recorded deposits and withdrawals, newest first, in ledger vocabulary (requested, submitted, confirmed, finalized, failed; only finalized and failed are terminal). ownerAddress is required; a wallet outside the active partner project answers 404. Reports on money that already moved, so no provider gate applies.

get/v1/earn/external-wallet/movements

Query parameters

ownerAddressstring required
direction'deposit' | 'withdrawal'
statusstring
limitinteger
beforestring

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

External-wallet movement page

Example response

{
  "data": {
    "ownerAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "movements": [
      {
        "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 11 revisions of this API.1