> ## 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 - Funded by

> Retrieve the earliest native SOL funders of a wallet via supported instructions: transfer, balance-changing createAccount, createAccountWithRedeem, UnwrapLamports, and WithdrawExcessLamports.

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Wallet provenance and source-of-funds lookup.</strong></p>

    <ul>
      <li>Use this endpoint to identify who first funded a Solana wallet with native SOL.</li>
      <li>The result is based on the earliest qualifying SOL funding event found in indexed history.</li>
      <li>Supported instruction patterns include direct transfer, balance-changing <code>createAccount</code>, <code>createAccountWithSeed</code>, <code>UnwrapLamports</code>, and <code>WithdrawExcessLamports</code>.</li>
      <li>This endpoint returns funding provenance, not portfolio balances, PnL, or transfer history.</li>
    </ul>
  </Tab>

  <Tab title="Accessibility">
    <ul>
      <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>30 CU</code> per request.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Trace the source wallet that initially funded a trader, sniper, or whale wallet.</li>
    <li>Cluster wallets that were seeded by the same origin wallet.</li>
    <li>Add provenance context to wallet research, top-trader analysis, and holder investigations.</li>
    <li>Support risk, compliance, and forensic workflows that need source-of-funds attribution.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain=solana</code>.</li>
    <li>Pass the target wallet in the <code>wallet</code> query parameter.</li>
    <li>Use the returned <code>funders</code> list and <code>tx\_hash</code> to connect the wallet back to its earliest known SOL funding event.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Combine this endpoint with wallet portfolio, PnL, and top-trader endpoints when you need both provenance and behavior.</li>
    <li>Treat the result as attribution context rather than proof of ultimate ownership.</li>
    <li>Cache results because earliest funding provenance is much less volatile than market or portfolio data.</li>
  </ul>
</Accordion>

<Accordion title="Limitations ⚠️" icon="fa-exclamation-triangle">
  <ul>
    <li>Solana only.</li>
  </ul>
</Accordion>


## OpenAPI

````yaml openapi/data/openapi_docs.json GET /wallet/v2/funded-by
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/funded-by:
    get:
      tags:
        - Wallet, Networth & PnL
      summary: Wallet - Funded by
      description: >-
        Retrieve the earliest native SOL funders of a wallet via supported
        instructions: transfer, balance-changing createAccount,
        createAccountWithRedeem, UnwrapLamports, and WithdrawExcessLamports.
      operationId: get-wallet-v2-funded-by
      parameters:
        - $ref: '#/components/parameters/xSolanaChainParam'
        - $ref: '#/components/parameters/walletAddressParam'
      responses:
        '200':
          $ref: '#/components/responses/WalletFundedByResponse'
        '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
    walletAddressParam:
      name: wallet
      description: The wallet of the account.
      in: query
      required: true
      schema:
        type: string
      examples:
        solana:
          value: eJpBLoF3bgXpzjxqJRAvMchjEo4EqdAmiQh3ASmEtZT
  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
    WalletFundedByResponse:
      description: >-
        JSON object containing the wallet that first funded the requested
        address with SOL, along with the funding details
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WalletFundedByResponseSchema'
          examples:
            Solana:
              value:
                success: true
                data:
                  funders:
                    - funder: AgmLJBMDCqWynYnQiPCuj9ewsNNsBJXyzoUhD9LJzN51
                      funder_name: MEV Bot
                    - funder: 4SnmsNwQLpBhuNvdjXQwafT6kV1BDvR6KgF3B9777wQd
                      funder_name: ''
                  token_address: So11111111111111111111111111111111111111111
                  token_decimals: 9
                  block_number: 403982922
                  unix_time: 1772558735
                  amount: 37030480
                  tx_hash: >-
                    2uAZx5CQ5AgrA21LbqZd7hFH5wit3Xm7w4fB3YeZCqCaUs6MS3SmoFfJ1jsAQDwgzgmieCjzYegNNwZprovJe5Vo
  schemas:
    WalletFundedByResponseSchema:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the request succeeded.
        data:
          type: object
          properties:
            funders:
              type: array
              description: Wallets associated with the first funding event.
              items:
                type: object
                required:
                  - funder
                  - funder_name
                properties:
                  funder:
                    type: string
                    description: Address of the wallet that funded the requested wallet.
                  funder_name:
                    type: string
                    description: Known name or label of the funding wallet, if available.
            token_address:
              type: string
              description: Token address used to fund the wallet.
            token_decimals:
              type: integer
              description: Number of decimals for the funding token.
            block_number:
              type: integer
              description: Block or slot number of the first funding event.
            unix_time:
              type: integer
              description: Unix timestamp in seconds of the first funding event.
            amount:
              type:
                - number
                - string
              description: >-
                Amount transferred in the first funding event, in the token's
                smallest unit.
            tx_hash:
              type: string
              description: Transaction hash of the first funding event.
    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

````