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.

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

Language

Credentials

Header

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

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.