{"uid":"cap_7doTAuzAydwbtOeIiLc8Q","slug":"vybe-solana-wallet-counterparties-endpoint-7859d8cc","name":"Vybe Solana Wallet Counterparties Endpoint","description":"Read access to Solana on-chain data — tokens, wallets, markets, prices, trades, transfers. No API key, no signup. Pay in USDC per request with the x402 protocol; the per-route price is declared in `x-payment-info`. WebSocket streaming uses prepaid credits.","url":"https://x402-api.vybenetwork.xyz/v4/wallets/%7BownerAddress%7D/counterparties?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["ownerAddress"],"properties":{"page":{"type":"integer","description":"Page number to return (zero-indexed). Defaults to 0."},"group":{"type":"string","description":"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'."},"limit":{"type":"integer","description":"Maximum number of counterparties to return. Defaults to 1000."},"timeEnd":{"type":"integer","description":"End of the time range (unix timestamp, seconds). Defaults to the current time."},"sortByAsc":{"type":"string","description":"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."},"timeStart":{"type":"integer","description":"Start of the time range (unix timestamp, seconds). Defaults to 24 hours ago."},"sortByDesc":{"type":"string","description":"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."},"ownerAddress":{"type":"string","description":"The Solana wallet address to query."}}},"responseSchema":{"$ref":"#/components/schemas/CounterpartyDataResponse"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EqzjMvQrzxIurl5u9ouGe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of counterparty wallets or programs that have transacted with a given Solana wallet, with transfer counts and volumes over a time range.","exampleAgentPrompt":"Show me the top 20 counterparty wallets for Solana address 7v91N7iZ9mNicL8WfG6cgSCKyRXydQjLh6UYBWwm6y1Q over the last 7 days, sorted descending by total volume, grouped by wallet.","exampleUseCases":null,"resultDescription":"A paginated list of counterparty entries, each identifying a wallet address or program address that transacted with the queried wallet, along with aggregated metrics: total transfers, buy transfers, sell transfers, total volume, buy volume, sell volume, and net volume — all scoped to the requested time window.","failureModes":["Invalid or malformed Solana wallet address returns a 400 or validation error","Both sortByAsc and sortByDesc provided simultaneously causes a parameter conflict error","No transactions found for the address in the time range returns an empty result set","x402 payment not included or insufficient USDC balance causes a 402 Payment Required response","Very large time ranges or high limit values may result in slower responses or timeouts"],"whenToPreferThis":"Use this endpoint when you need to understand the social or transactional graph of a specific Solana wallet — i.e. who it trades with, which programs it uses, and the relative volume of those relationships. It is the right choice over raw transfer history endpoints when you want aggregated counterparty-level summaries rather than individual transaction records. Prefer it for DeFi due-diligence, wallet profiling, bot detection, or identifying top trading partners.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-28T06:46:20.140Z","isFirstParty":false,"canonicalSlug":"vybe-solana-wallet-counterparties-endpoint-7859d8cc"}