Skip to main content
POST
Get fee share wallets (bulk, v2)

Choosing a chain per item

Each item accepts an optional chain field:
  • SOL (default when omitted) — returns the user’s Solana embedded wallet as a base58 address.
  • EVM — resolves the user’s Ethereum embedded wallet from Privy, creating one if the user has none, and returns a 0x… address.
The resolved chain is always echoed back on every result item.

Deduplication

Deduplication is performed on the username + provider + chain triple. The same username + provider may appear twice in one request as long as the chain differs (once for SOL, once for EVM). Two items with an identical username + provider + chain triple are rejected with a 400 error.
Bulk lookups never fail an individual item: when a wallet or platform data can’t be resolved, that item comes back with platformData: null and wallet: null, but chain is always echoed back. The solana provider only supports SOL; combining it with chain=EVM returns a 400 error.

Authorizations

x-api-key
string
header
required

API key authentication. Provide your API key as the header value.

Body

application/json
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).

Required array length: 1 - 100 elements

Response

Successfully retrieved wallet addresses for all requested items

success
enum<boolean>
required
Available options:
true
response
object[]
required

Per-item results matching the input order