Earn

Get external-wallet position totals

Returns a complete live aggregate across the active partner project's end-user wallets, grouped by strategy and token. The service pages every stored claim before hydration. A total is omitted when any contributing live value is unavailable, never reported as zero or partial.

get/v1/earn/external-wallet/positions/summary

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

Complete external-wallet position aggregate

Example response

{
  "data": {
    "summary": {
      "totalsByStrategy": [
        {
          "provider": "kamino",
          "providerReference": "7uib8xGAwkaPz4ZGCA6t8sSEid5Yp9ty13PHUweTypx",
          "label": "Allez USDC",
          "totalsByToken": [
            {
              "tokenMint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
              "tokenValue": "25.42"
            }
          ]
        }
      ],
      "totalsByToken": [
        {
          "tokenMint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
          "tokenValue": "25.42"
        }
      ]
    }
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes

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