Wallet Counterparties

get

https://api.vybenetwork.xyz/v4/wallets/{ownerAddress}/counterparties

Solana API endpoint for fetching wallet counterparties. Analyze transfer relationships, volumes and interactions with wallets or programs over time.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Fetch counterparties for any Solana wallet based on token transfer activity within a specified time range. Analyze interactions with other wallets or on-chain programs, including transfer counts, buy and sell volumes, net flow and top tokens involved.

This endpoint enables deeper insight into trading relationships, helping identify key liquidity sources, frequently used protocols, and behavioral patterns in wallet activity across the Solana ecosystem.

Returns the wallets or programs that a given wallet has interacted with via token transfers within a time window. Results include transfer counts, volume in USD (buy/sell/net) and the top tokens involved per counterparty.

Defaults to the last 24 hours, grouped by wallet, with up to 1000 results. Use this to analyze a wallet's trading relationships. For example, identifying which DEX programs or walletsaccount for most of its transfer activity.

Path Params

ownerAddress

string

required

The Solana wallet address to query.

Query Params

group

string | null

enum

How to group counterparties. 'wallet' groups by the other wallet address involved in transfers. 'program' groups by the on-chain program that facilitated the transfer (e.g. a DEX). Defaults to 'wallet'.

Allowed:

limit

int32 | null

≥ 0

Maximum number of counterparties to return. Defaults to 1000.

page

int32 | null

≥ 0

Page number to return (zero-indexed). Defaults to 0.

timeStart

int64 | null

≥ 0

Start of the time range (unix timestamp, seconds). Defaults to 24 hours ago.

timeEnd

int64 | null

≥ 0

End of the time range (unix timestamp, seconds). Defaults to the current time.

sortByAsc

string | null

Sort ascending by 'totalTransfers', 'totalVolume', 'netVolume', 'sellTransfers', 'buyTransfers', 'sellVolume', or 'buyVolume'. If omitted, no sorting is applied. Only one of sortByAsc or sortByDesc can be used.

sortByDesc

string | null

Sort descending by 'totalTransfers', 'totalVolume', 'netVolume', 'sellTransfers', 'buyTransfers', 'sellVolume', or 'buyVolume'. If omitted, no sorting is applied. Only one of sortByAsc or sortByDesc can be used.

Responses

200List of counterparties with transfer counts, volumes, and top tokens for each.

400Invalid parameters — check that timeStart < timeEnd, limit does not exceed 1000, and only one of sortByAsc/sortByDesc is set.

500Unexpected server error. The response body includes an id field — provide this when contacting support.