---
title: "Get fee share wallets (bulk, v2)"
method: POST
path: "/token-launch/fee-share/wallet/v2/bulk"
tags: ["Fee Share"]
---

# Get fee share wallets (bulk, v2)

`POST /token-launch/fee-share/wallet/v2/bulk`

Bulk lookup of wallet addresses associated with social providers and usernames for fee sharing. Each item accepts an optional `chain` (`SOL` default, or `EVM`); the resolved `chain` is echoed back on every result. Deduplication is performed on `username + provider + chain`, so the same handle may appear once per chain. Items are never individually failed: when a wallet or platform data can't be resolved, that item returns `platformData: null` and `wallet: null` while still echoing `chain`.

## Request body

- GetFeeShareWalletV2BulkRequest
  - `items` object[], required — Array of lookups (1-100). Duplicate username+provider+chain combinations are not allowed. The same username+provider may appear once per chain (once for SOL, once for EVM).
    - `username` string, required — Username/handle on the provider platform. Input is normalized to lowercase; leading @ is removed if present.
    - `provider` 'apple' | 'google' | 'email' | 'solana' | 'twitter' | 'tiktok' | 'kick' | 'instagram' | 'onlyfans' | 'github' | 'moltbook', required — Supported social/auth providers
    - `chain` 'SOL' | 'EVM' — Blockchain to resolve the wallet on. `SOL` returns the user's Solana embedded wallet (base58). `EVM` returns the user's Ethereum embedded wallet from Privy (`0x…`). Defaults to `SOL` when omitted. The `solana` provider only supports `SOL`.

## Response `200`

Successfully retrieved wallet addresses for all requested items

- GetFeeShareWalletV2BulkSuccessResponse
  - `success` true, required
  - `response` GetFeeShareWalletV2BulkResultItem[], required — Per-item results matching the input order
    - `username` string, required — Username/handle on the provider platform (normalized to lowercase; leading @ removed if provided)
    - `provider` 'apple' | 'google' | 'email' | 'solana' | 'twitter' | 'tiktok' | 'kick' | 'instagram' | 'onlyfans' | 'github' | 'moltbook', required — Supported social/auth providers
    - `platformData` SocialProviderUserData, required — Generic user data structure that works across different OAuth providers
      - `id` string, required — Unique identifier of the user on the provider platform
      - `username` string, required — Username/handle on the provider platform
      - `display_name` string, required — Display name of the user on the provider platform
      - `avatar_url` string, required — Profile picture URL of the user on the provider platform
    - `wallet` string, nullable, required — Address of the resolved wallet, or null if not found. Format depends on `chain`: base58 for `SOL`, `0x…` for `EVM`.
    - `chain` 'SOL' | 'EVM', required — Blockchain to resolve the wallet on. `SOL` returns the user's Solana embedded wallet (base58). `EVM` returns the user's Ethereum embedded wallet from Privy (`0x…`). Defaults to `SOL` when omitted. The `solana` provider only supports `SOL`.

## Other responses

- `400` — Bad request - Invalid parameters, duplicate username + provider + chain combinations, or the solana provider combined with the EVM chain
- `401` — Unauthorized - Invalid or missing API key
- `500` — Internal server error

---

[API](https://skmtc.net/bags/apis/bags-public-api-v2.md) · [All operations](https://skmtc.net/bags/apis/bags-public-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bags/bags-public-api-v2/revisions/4a14b82cd39d/schema)