> ## Documentation Index > Fetch the complete documentation index at: https://docs.spritz.finance/llms.txt > Use this file to discover all available pages before exploring further. # Get wallet portfolio snapshots > Returns the authenticated user's portfolio snapshot history for the requested range. `latest` and `baseline` reference the newest and oldest snapshots inside the range; `changeUsd`/`changePercent` are simple balance deltas (not P&L). New users with no snapshots return `latest`/`baseline` as null and an empty `points` array. ## OpenAPI ````yaml https://platform.spritz.finance/openapi.json get /v1/wallet-kit/portfolio/snapshots openapi: 3.0.3 info: title: Spritz Finance API version: 1.0.0 description: API for the Spritz Finance platform with RFC 9457 error handling servers: - url: https://platform.spritz.finance description: Production - url: https://sandbox.spritz.finance description: Sandbox security: [] tags: - name: Users description: User management endpoints - name: Bank Accounts description: Manage bank accounts for off-ramp destinations - name: Bills description: Manage bill pay accounts - name: Cards description: Spritz-issued debit cards - name: Auto-Ramp Accounts description: Virtual bank accounts that automatically convert fiat deposits to crypto - name: Spritz App description: >- Endpoints used by the Spritz app and internal SDKs. Excluded from the public partner spec. paths: /v1/wallet-kit/portfolio/snapshots: get: tags: - Wallet Kit summary: Get wallet portfolio snapshots description: >- Returns the authenticated user's portfolio snapshot history for the requested range. `latest` and `baseline` reference the newest and oldest snapshots inside the range; `changeUsd`/`changePercent` are simple balance deltas (not P&L). New users with no snapshots return `latest`/`baseline` as null and an empty `points` array. operationId: getV1Wallet-kitPortfolioSnapshots parameters: - name: range in: query required: false schema: type: string enum: - 1d - 7d - 30d - 90d - 1y - all responses: '200': description: >- Portfolio snapshot history for the authenticated user's wallets. `changeUsd` and `changePercent` are simple balance deltas, not P&L. New users with no history return `latest`/`baseline` as null and `points` empty. content: application/json: schema: description: >- Portfolio snapshot history for the authenticated user's wallets. `changeUsd` and `changePercent` are simple balance deltas, not P&L. New users with no history return `latest`/`baseline` as null and `points` empty. type: object properties: range: type: string enum: - 1d - 7d - 30d - 90d - 1y - all latest: description: >- Newest snapshot inside the requested range, or null when no snapshots exist. type: object properties: id: description: Stable identifier for the snapshot point. type: string bucketStart: format: date-time description: >- ISO 8601 timestamp marking the start of the time bucket this snapshot represents. type: string capturedAt: format: date-time description: >- ISO 8601 timestamp at which the snapshot was actually captured. type: string status: description: >- `complete` when every wallet was captured successfully; `partial` when one or more wallets failed or are unsupported. anyOf: - type: string enum: - complete - type: string enum: - partial totalBalanceUsd: description: >- Total USD balance across all captured wallets at this point, formatted to two decimal places. type: string example: '1234.56' assetCount: minimum: 0 description: Distinct asset count at this point. type: integer chainCount: minimum: 0 description: Distinct chain count at this point. type: integer walletCount: minimum: 0 description: Total wallet count considered for this point. type: integer capturedWalletCount: minimum: 0 description: Number of wallets that were captured successfully. type: integer unsupportedWalletCount: minimum: 0 description: >- Number of wallets skipped because their chain is not yet supported. type: integer failedWalletCount: minimum: 0 description: Number of wallets that failed to capture. type: integer required: - id - bucketStart - capturedAt - status - totalBalanceUsd - assetCount - chainCount - walletCount - capturedWalletCount - unsupportedWalletCount - failedWalletCount nullable: true baseline: description: >- Oldest snapshot inside the requested range, or null when no snapshots exist. type: object properties: id: description: Stable identifier for the snapshot point. type: string bucketStart: format: date-time description: >- ISO 8601 timestamp marking the start of the time bucket this snapshot represents. type: string capturedAt: format: date-time description: >- ISO 8601 timestamp at which the snapshot was actually captured. type: string status: description: >- `complete` when every wallet was captured successfully; `partial` when one or more wallets failed or are unsupported. anyOf: - type: string enum: - complete - type: string enum: - partial totalBalanceUsd: description: >- Total USD balance across all captured wallets at this point, formatted to two decimal places. type: string example: '1234.56' assetCount: minimum: 0 description: Distinct asset count at this point. type: integer chainCount: minimum: 0 description: Distinct chain count at this point. type: integer walletCount: minimum: 0 description: Total wallet count considered for this point. type: integer capturedWalletCount: minimum: 0 description: Number of wallets that were captured successfully. type: integer unsupportedWalletCount: minimum: 0 description: >- Number of wallets skipped because their chain is not yet supported. type: integer failedWalletCount: minimum: 0 description: Number of wallets that failed to capture. type: integer required: - id - bucketStart - capturedAt - status - totalBalanceUsd - assetCount - chainCount - walletCount - capturedWalletCount - unsupportedWalletCount - failedWalletCount nullable: true changeUsd: type: string description: >- Simple USD balance delta between baseline and latest, formatted to two decimal places. Not P&L. Null when history is empty. nullable: true example: '12.34' changePercent: type: string description: >- Simple percentage change between baseline and latest balance, formatted to two decimal places. Not P&L. Null when history is empty or baseline balance is zero. nullable: true example: '1.23' points: description: >- Snapshot points inside the requested range, ordered by `bucketStart`. Empty when no history exists. type: array items: description: >- A single point in the user's portfolio snapshot history. `totalBalanceUsd` is a USD amount, not P&L. type: object properties: id: description: Stable identifier for the snapshot point. type: string bucketStart: format: date-time description: >- ISO 8601 timestamp marking the start of the time bucket this snapshot represents. type: string capturedAt: format: date-time description: >- ISO 8601 timestamp at which the snapshot was actually captured. type: string status: type: string enum: - complete - partial totalBalanceUsd: description: >- Total USD balance across all captured wallets at this point, formatted to two decimal places. type: string example: '1234.56' assetCount: minimum: 0 description: Distinct asset count at this point. type: integer chainCount: minimum: 0 description: Distinct chain count at this point. type: integer walletCount: minimum: 0 description: Total wallet count considered for this point. type: integer capturedWalletCount: minimum: 0 description: Number of wallets that were captured successfully. type: integer unsupportedWalletCount: minimum: 0 description: >- Number of wallets skipped because their chain is not yet supported. type: integer failedWalletCount: minimum: 0 description: Number of wallets that failed to capture. type: integer required: - id - bucketStart - capturedAt - status - totalBalanceUsd - assetCount - chainCount - walletCount - capturedWalletCount - unsupportedWalletCount - failedWalletCount required: - range - latest - baseline - changeUsd - changePercent - points '401': description: Response for status 401 content: application/json: schema: type: object properties: type: default: about:blank description: A URI reference that identifies the problem type type: string example: urn:problem-type:auth:unauthorized title: description: A short, human-readable summary of the problem type type: string example: Unauthorized status: description: The HTTP status code type: number example: 401 detail: description: A human-readable explanation specific to this occurrence type: string example: Bearer token required instance: description: A URI reference that identifies the specific occurrence type: string realm: description: The authentication realm type: string example: API scope: description: The required scope for this resource type: string example: read:users required: - title - status additionalProperties: false '500': description: Response for status 500 content: application/json: schema: type: object properties: type: default: about:blank description: A URI reference that identifies the problem type type: string example: urn:problem-type:auth:unauthorized title: description: A short, human-readable summary of the problem type type: string example: Unauthorized status: description: The HTTP status code type: number example: 400 detail: description: A human-readable explanation specific to this occurrence type: string instance: description: A URI reference that identifies the specific occurrence type: string example: /errors/1234567890 code: description: >- Machine-readable cause, present when exactly one thing failed. Branch on this, never on `detail`, which is human-facing copy and may change. For deposit limits the vocabulary matches the `reason` values the limits API returns pre-flight. type: string example: transaction_limit field: description: The offending request field, present alongside `code`. type: string example: amountUsd retryable: description: >- Whether retrying the same request later may succeed without changing its inputs. type: boolean example: true required: - title - status additionalProperties: false security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Cognito JWT token for regular user authentication ````