Sign in
Earn

Get one external wallet's balance and earnings

Returns live balance and total earned per deposit token: earned is live value minus finalized SDP deposits, stated only when exact. When it cannot be stated — live value unavailable, movements still settling, or a finalized withdrawal on a held position — the figure is absent with a named reason, never zero. Figures cover currently held positions: a fully exited position's history drops out (it stays on the movements list). Live value reads the owner's whole vault balance, so shares acquired outside SDP inflate it.

get/v1/earn/external-wallet/earnings/{ownerAddress}

Path parameters

ownerAddressstring 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

External-wallet earnings

Example response

{
  "data": {
    "earnings": {
      "ownerAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "totalsByToken": [
        {
          "tokenMint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
          "currentValue": "25.42",
          "totalDeposited": "25.42",
          "earned": "5.2"
        }
      ]
    }
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes

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