> ## Documentation Index
> Fetch the complete documentation index at: https://docs.defindex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an account's flat transaction history in a vault

> Returns a paginated list of deposit, withdraw, transfer_in, and transfer_out events for a given account in a vault, sorted newest-first by ledger. Use for tx-table / activity-log UIs. The performance endpoint (`/account/:wallet/vault/:vault`) is the right place for chart data with per-bucket event annotations.



## OpenAPI

````yaml GET /account/{walletAddress}/vault/{vaultAddress}/events
openapi: 3.0.0
info:
  title: DeFindex API
  description: >-
    Yield infrastructure for neobanks, fintechs and wallets.


    **Base URL:** `https://api.defindex.io`. Every route takes
    `?network=mainnet` (the default) or `?network=testnet`.


    **Auth:** send your API key as `Authorization: Bearer sk_...` (the console
    uses the JWT access token from `POST /login` the same way). Each operation's
    `security` says whether it needs one; `security: []` means it is public.

    - `401`: no credential, or an invalid API key. The body has a `code`
    (`MISSING_CREDENTIAL` or `INVALID_API_KEY`) and a `registerUrl` where you
    get a key, and `WWW-Authenticate` is set.

    - `403`: an expired or invalid JWT, or a valid credential without the
    required role.


    **Rate limits:** a token bucket per account (requests without a key are
    tracked by IP). Responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining`
    and `X-RateLimit-Reset` (seconds until the bucket is full). A `429` also
    carries `Retry-After` and `retryAfter` in the body.


    | Tier | Burst | Sustained |

    |---|---|---|

    | FREE | 5 | 1/s |

    | STARTER | 20 | 10/s |

    | PROFESSIONAL | 100 | 50/s |

    | BUSINESS | 200 | 100/s |


    **Units:**

    - Amounts are integers in the asset's smallest unit (7 decimals for every
    asset DeFindex lists today: 1 USDC = `10000000`). Responses send them as
    strings; request bodies take JSON integers.

    - Vault shares (dfTokens) are not underlying: `GET /vault/{address}/balance`
    returns both. The share price rises, so the underlying value of a position
    is not what was deposited.

    - Multi-asset vaults take one amount per vault asset, in the order of
    `assets` in `GET /vault/{address}`.

    - Vault `apy` is a percentage (`8.75` = 8.75%). `/strategies`
    `apy7d`/`apy30d`/`apyAllTime` are fractions (`0.0641` = 6.41%).

    - Fees are basis points (`10000` = 100%).


    **Writes never move funds by themselves.** Each write returns an unsigned
    transaction (`xdr`) for the `caller`. Sign it and submit it with `POST
    /send` (or your own RPC). `POST /send` is idempotent: resubmitting the same
    signed XDR returns the original result.
  version: 1.0.0
  contact: {}
  x-logo:
    url: https://links.paltalabs.io/defindex-full.svg
    backgroundColor: '#0e0e0e'
    altText: DeFindex Logo
    href: https://defindex.io
servers: []
security: []
tags: []
paths:
  /account/{walletAddress}/vault/{vaultAddress}/events:
    get:
      tags:
        - Historical Data
      summary: Get an account's flat transaction history in a vault
      description: >-
        Returns a paginated list of deposit, withdraw, transfer_in, and
        transfer_out events for a given account in a vault, sorted newest-first
        by ledger. Use for tx-table / activity-log UIs. The performance endpoint
        (`/account/:wallet/vault/:vault`) is the right place for chart data with
        per-bucket event annotations.
      operationId: HistoricalDataController_getAccountEvents
      parameters:
        - name: walletAddress
          required: true
          in: path
          description: Stellar account address
          schema:
            example: GCXD3P3ALY3HNFZ6BWCDSXIAV5N2RPVDWYF4O63FE7FB3YNFHAZRHKZ6
            type: string
        - name: vaultAddress
          required: true
          in: path
          description: Vault contract address
          schema:
            example: CBBAH2OAJ6N3UBJGXNFYH4QF6C6OWO4RHGGOOGDER3IJB7SGLR3Y56JO
            type: string
        - name: network
          required: true
          in: query
          description: Stellar network (mainnet or testnet)
          schema:
            enum:
              - testnet
              - mainnet
            type: string
        - name: eventType
          required: false
          in: query
          description: >-
            Filter by event type: deposit, withdraw, transfer_in, transfer_out.
            Omit for all.
          schema:
            type: string
            enum:
              - deposit
              - withdraw
              - transfer_in
              - transfer_out
        - name: startDate
          required: false
          in: query
          description: Start date in ISO 8601 format
          schema:
            example: '2026-01-01T00:00:00.000Z'
            type: string
        - name: endDate
          required: false
          in: query
          description: End date in ISO 8601 format
          schema:
            example: '2026-04-22T00:00:00.000Z'
            type: string
        - name: limit
          required: false
          in: query
          description: Page size (max 200)
          schema:
            default: 50
            type: number
        - name: offset
          required: false
          in: query
          description: Pagination offset
          schema:
            default: 0
            type: number
      responses:
        '200':
          description: Paginated events list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountEventsResponse'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
            x-correlation-id:
              $ref: '#/components/headers/x-correlation-id'
        '401':
          description: >-
            No credential, an invalid API key, or a valid JWT of a disabled
            account. Except for the disabled account, the answer carries
            `WWW-Authenticate` and a `registerUrl`.
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
            x-correlation-id:
              $ref: '#/components/headers/x-correlation-id'
        '403':
          description: >-
            An expired or invalid JWT, or a valid credential without the
            required role.
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
            x-correlation-id:
              $ref: '#/components/headers/x-correlation-id'
        '429':
          description: >-
            Rate limit exceeded for your tier. Wait `Retry-After` seconds and
            retry.
          headers:
            Retry-After:
              description: Seconds until the next request is allowed.
              schema:
                type: integer
                example: 1
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
            x-correlation-id:
              $ref: '#/components/headers/x-correlation-id'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 429
                  message:
                    type: string
                    example: Rate limit exceeded
                  error:
                    type: string
                    example: Too Many Requests
                  retryAfter:
                    type: integer
                    example: 1
              example:
                statusCode: 429
                message: Rate limit exceeded
                error: Too Many Requests
                retryAfter: 1
      security:
        - bearer: []
components:
  schemas:
    AccountEventsResponse:
      type: object
      properties:
        accountAddress:
          type: string
        vaultAddress:
          type: string
        network:
          type: string
        pagination:
          type: object
          description: Pagination info
          example:
            limit: 50
            offset: 0
            total: 3
        events:
          description: Transaction events, newest-first by ledger
          type: array
          items:
            type: object
      required:
        - accountAddress
        - vaultAddress
        - network
        - pagination
        - events
  headers:
    X-RateLimit-Limit:
      description: 'Bucket size for your tier: the most requests you can burst.'
      schema:
        type: integer
        example: 5
    X-RateLimit-Remaining:
      description: Requests left in the bucket right now.
      schema:
        type: integer
        example: 4
    X-RateLimit-Reset:
      description: >-
        Seconds (not a timestamp) until the bucket is full again. On a 429,
        seconds until the next request is allowed.
      schema:
        type: integer
        example: 1
    x-correlation-id:
      description: >-
        Request ID. Send your own `x-correlation-id` to have it echoed back;
        quote it when you report a problem.
      schema:
        type: string
        example: 454a42d5-0166-40fe-a4ad-32e77aa44962
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.