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

# Wallet - Transfer total

> Retrieve total transfer of the wallet.

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Cheap transfer-count summary for one Solana wallet.</strong></p>

    <ul>
      <li>Solana transfer data is available from epoch <code>257</code> (<code>2021-11-12</code>).</li>
      <li>Use the same wallet and transfer filters as the wallet-transfer list when you only need aggregate counts.</li>
      <li>This endpoint returns totals, not the underlying transfer rows.</li>
    </ul>
  </Tab>

  <Tab title="Accessibility">
    <ul>
      <li>Standard</li>
      <li>Lite</li>
      <li>Starter</li>
      <li>Premium</li>
      <li>Business</li>
      <li>Enterprise</li>
    </ul>
  </Tab>

  <Tab title="Chain Supported">
    <p><strong>Solana</strong></p>
  </Tab>
</Tabs>

<Accordion title="Compute Unit ⚙️" icon="fa-gauge-high">
  <ul>
    <li>This endpoint consumes <code>1 CU</code> per request.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Count wallet transfers before pulling the full list.</li>
    <li>Show transfer activity totals in wallet dashboards or summary cards.</li>
    <li>Prefilter high-activity wallets before full forensic review.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain=solana</code>.</li>
    <li>Send the wallet and any transfer filters in the POST body.</li>
    <li>Use the returned count to decide whether you need the full wallet-transfer list.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Use this endpoint as a cheap preflight before paginating transfer rows.</li>
    <li>Keep the filter set identical to the transfer-list call if you plan to compare totals and rows.</li>
  </ul>
</Accordion>

<Accordion title="Limitations ⚠️" icon="fa-exclamation-triangle">
  <ul>
    <li>Solana only.</li>
    <li>Historical coverage starts from epoch <code>257</code> (<code>2021-11-12</code>).</li>
    <li>Returns totals only, not transfer row details.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json POST /wallet/v2/transfer/total
openapi: 3.1.0
info:
  version: 1.1.0
  title: Birdeye Data API
  description: >-
    Birdeye Data API is a full-spectrum blockchain and DEX data platform for
    teams that need production-grade crypto market intelligence across tokens,
    pairs, wallets, traders, protocols, and chains.


    From real-time prices, OHLCV, liquidity, and transaction flow to holder
    analytics, token and pair overviews, wallet portfolio and PnL, smart money,
    discovery, security, and blockchain-level utilities, Birdeye gives you a
    unified data layer for building serious crypto products at scale.


    Use it to power exchange interfaces, trading terminals, bots, market-making
    systems, quant research, alpha screeners, portfolio apps, wallet
    intelligence tools, alerting systems, analytics dashboards, and back-office
    data pipelines. Whether your users are retail traders, pro desks, analysts,
    or infrastructure teams, Birdeye helps you ship faster with broad market
    coverage and API surfaces that support both lightweight integrations and
    data-heavy workflows.


    To start, create an account at [bds.birdeye.so](https://bds.birdeye.so),
    generate an API key from the `Security` tab, and send it in the `X-API-KEY`
    header on every request.
servers:
  - url: https://public-api.birdeye.so
security:
  - apiKeyAuth: []
tags:
  - name: Price & OHLCV
  - name: Stats
  - name: Token/Market List
  - name: Transactions
  - name: Wallet, Networth & PnL
  - name: Balance & Transfer
  - name: Holder
  - name: Alltime & History
  - name: Blockchain
  - name: Account
  - name: Token
  - name: Transaction
  - name: Creation & Trending
  - name: Meme
  - name: Security
  - name: Search & Utils
  - name: Smart Money
  - name: Global Fees Paid
  - name: DEX & Protocol
  - name: Wallet Identity
paths:
  /wallet/v2/transfer/total:
    post:
      tags:
        - Balance & Transfer
      summary: Wallet - Transfer total
      description: Retrieve total transfer of the wallet.
      operationId: post-wallet-v2-transfer-total
      parameters:
        - $ref: '#/components/parameters/xSolanaChainParam'
      requestBody:
        $ref: '#/components/requestBodies/totalWalletTransfer'
      responses:
        '200':
          $ref: '#/components/responses/TotalTransferResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
components:
  parameters:
    xSolanaChainParam:
      name: x-chain
      description: Solana network only.
      in: header
      required: false
      schema:
        type: string
        enum:
          - solana
        default: solana
  requestBodies:
    totalWalletTransfer:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TotalWalletTransferBody'
          examples:
            solana:
              value:
                wallet: 41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu
                token_address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                time_from: 1727788070
                time_to: 1727788076
                flow: in
                from_amount: 10.01
                to_amount: 10.001
                from_value: 1.001
                to_value: 10000
                from_wallet: 41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu
                to_wallet: 41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Bad request
    '401':
      description: Unauthorized. API key is missing or invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Unauthorized
    '403':
      description: Forbidden. Request is blacklisted or not whitelisted
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Access Denied
    '429':
      description: Too Many Requests. Rate limit reached
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Too many requests
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Internal Server Error
    TotalTransferResponse:
      description: JSON object containing a total transfer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TotalTransferResponseSchema'
          examples:
            Solana:
              value:
                success: true
                data:
                  total: 10
  schemas:
    TotalWalletTransferBody:
      required:
        - wallet
      type: object
      properties:
        wallet:
          type: string
          description: Address of the wallet to retrieve transfers for.
          example: 41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu
        token_address:
          type: string
          description: Address of the token to filter transfers by.
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        flow:
          type: string
          description: >-
            Transfer direction relative to the specified wallet. Use `in` for
            incoming transfers or `out` for outgoing transfers.
          enum:
            - in
            - out
          example: in
        time_from:
          type: number
          description: Start of the transfer time range as a Unix timestamp.
          example: 1727788070
        time_to:
          type: number
          description: End of the transfer time range as a Unix timestamp.
          example: 1727788076
        from_amount:
          type: number
          description: Minimum token amount to include.
          example: 10.01
        to_amount:
          type: number
          description: Maximum token amount to include.
          example: 10.001
        from_value:
          type: number
          description: Minimum transfer value in USD to include.
          example: 1.001
        to_value:
          type: number
          description: Maximum transfer value in USD to include.
          example: 10000
        from_wallet:
          type: string
          description: Address of the sender wallet to filter transfers by.
          example: 41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu
        to_wallet:
          type: string
          description: Address of the recipient wallet to filter transfers by.
          example: 41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu
    TotalTransferResponseSchema:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the request succeeded.
        data:
          type: object
          properties:
            total:
              type: integer
              description: Total number of transfer records matching the filters.
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication

````