Marketplace catalog
Browse aged wallets for sale, with filter bounds, funding sources and native token prices.
The Marketplace (internally Hushxima) sells pre-funded, aged wallets. Proxima fronts an external marketplace API: responses keep its field names, and the API removes the seller-side fields (cost basis, margins, organisation ids) before answering.
Use List catalog wallets to page through wallets that match a filter and Count catalog wallets for the matching total. Retrieve catalog facets and List funding sources feed the filter controls. Selected wallet ids then go into a quote — see Marketplace orders.
Chains use marketplace slugs (solana, ethereum, bsc, base, robinhood, arc), not Proxima chain ids. Native amounts are integer strings in the chain's smallest unit; parse them as big integers. Upstream errors with status 400, 404, 409, 422 or 429 are passed through with their message. Other upstream failures answer 422 with code upstream_failure and service: "hushxima". The web app shows the Marketplace only on chains whose marketplace feature flag is on.
The Catalog wallet object
A wallet listed for sale. The client type also declares seller-side fields (cost_basis, owner_org_id, buyer_ref, sale_id, imported, aging_status, target_age_days); the API removes them from buyer responses.
Attributes
-
idstringMarketplace wallet id (UUID). Pass it inwallet_idswhen you create a quote. -
pubkeystringWallet address. The API withholds it from catalog listings; it becomes readable on quote and purchase wallet lines once the wallet is yours. -
networkstringNetwork family the wallet belongs to. -
chainstring | nullMarketplace chain slug, e.g.solana. -
statusstringListing status reported by the marketplace. -
balancestringNative balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
tx_countintegerNumber of on-chain transactions. -
funded_atstring | nullWhen the wallet was first funded (RFC 3339). -
first_tx_atstring | nullFirst on-chain activity (RFC 3339). -
last_tx_atstring | nullLatest on-chain activity (RFC 3339). -
created_atstringWhen the marketplace created the wallet (RFC 3339). -
funding_sourcestring | nullFunding provider slug. -
funding_exchangestring | nullExchange behind a CEX-funded wallet, e.g.binance. The web app shows it in preference tofunding_source. -
sold_atstring | nullWhen the wallet was sold (RFC 3339). -
source_kindstring | nullFunding kind. The web app falls back to it when no funding source or exchange is set. -
tierstring | nullActivity tier:tier0(funding only),tier1(light on-chain history),tier2(activity plus token holdings). -
persona_namestring | nullActivity persona, e.g.conservative_retail,active_trader,defi_power_user,long_term_holder. -
timezone_namestring | nullTimezone slug the wallet's activity follows, e.g.americas_et_eveningorasia_jst_evening. -
user_pricestring | nullCurrent sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. This is what a quote charges for the wallet. -
token_holdingsarray<object> | nullTokens the wallet holds, with their USD value.Child attributes 6
-
mintstringToken mint or contract address. -
symbolstring | nullToken symbol, when known. -
decimalsinteger | nullToken decimals. -
balancestringRaw token balance as an integer string. Divide by10^decimals(and applyui_multiplier) for display. -
ui_multiplierstring | nullDisplay multiplier scaled by 1e18, for tokens whose UI amount differs from the raw amount. -
usd_valuenumber | nullUSD value of the holding.
-
List catalog wallets
/marketplace/catalog Returns a page of wallets for sale that match the filters.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Keyset-paginated: pass the previous page's next_cursor as cursor to fetch the next page. The Marketplace page requests 500 wallets per page and builds the lot to buy from them. Empty filter values are not sent.
Query parameters
-
chainenum RequiredMarketplace chain slug. These are marketplace slugs, not Proxima chain ids.Possible valuessolanaethereumbscbaserobinhoodarc -
countinteger OptionalPage size. The web app requests500. -
cursorstring | null OptionalCursor from a previous page'snext_cursor. -
min_balancestring OptionalMinimum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
max_balancestring OptionalMaximum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
min_pricestring OptionalMinimum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
max_pricestring OptionalMaximum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
min_age_daysinteger OptionalMinimum wallet age, in days. The web app defaults to1. -
max_age_daysinteger OptionalMaximum wallet age, in days. -
min_tx_countinteger OptionalMinimum number of on-chain transactions. -
max_tx_countinteger OptionalMaximum number of on-chain transactions. -
sourcesstring OptionalComma-separated funding sources, as returned by List funding sources.Examplebinance,kucoin -
tierstring OptionalComma-separated activity tiers, e.g.tier0,tier1. -
personastring OptionalActivity persona, e.g.active_trader. Not set by the web app. -
timezonestring OptionalComma-separated activity timezone slugs, e.g.europe,europe_cet_evening. The web app expands each region it shows into the slugs it covers. -
min_funding_gap_secondsinteger OptionalMinimum spacing, in seconds, between wallet funding timestamps. The web app defaults to1800(30 minutes) to limit funding-time clustering. -
gap_withstring OptionalComma-separated Unix timestamps (seconds) of existing wallets whose funding times the results must also stay apart from. The web app sends the funding times of the destination folders' wallets, only together withmin_funding_gap_seconds. -
sortstring OptionalSort field. Not set by the web app. -
orderstring OptionalSort direction. Not set by the web app.
Returns 200 OK · application/json
Returns a page of Catalog wallet objects.
-
itemsarray<object>Wallets on this page. See Catalog wallet. -
next_cursorstring | nullCursor for the next page;nullon the last page.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries service: "hushxima". Retry after a short wait; the failure is on the marketplace side. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.hushxima.getCatalog(params) src/lib/proxima/endpoints/hushxima.ts
Count catalog wallets
/marketplace/catalog/count Returns how many wallets match the filters.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Takes the same filters as List catalog wallets. The Marketplace page shows it as the matching total.
Query parameters
-
chainenum RequiredMarketplace chain slug. These are marketplace slugs, not Proxima chain ids.Possible valuessolanaethereumbscbaserobinhoodarc -
min_balancestring OptionalMinimum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
max_balancestring OptionalMaximum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
min_pricestring OptionalMinimum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
max_pricestring OptionalMaximum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
min_age_daysinteger OptionalMinimum wallet age, in days. The web app defaults to1. -
max_age_daysinteger OptionalMaximum wallet age, in days. -
min_tx_countinteger OptionalMinimum number of on-chain transactions. -
max_tx_countinteger OptionalMaximum number of on-chain transactions. -
sourcesstring OptionalComma-separated funding sources, as returned by List funding sources.Examplebinance,kucoin -
tierstring OptionalComma-separated activity tiers, e.g.tier0,tier1. -
personastring OptionalActivity persona, e.g.active_trader. Not set by the web app. -
timezonestring OptionalComma-separated activity timezone slugs, e.g.europe,europe_cet_evening. The web app expands each region it shows into the slugs it covers. -
min_funding_gap_secondsinteger OptionalMinimum spacing, in seconds, between wallet funding timestamps. The web app defaults to1800(30 minutes) to limit funding-time clustering. -
gap_withstring OptionalComma-separated Unix timestamps (seconds) of existing wallets whose funding times the results must also stay apart from. The web app sends the funding times of the destination folders' wallets, only together withmin_funding_gap_seconds. -
sortstring OptionalSort field. Not set by the web app. -
orderstring OptionalSort direction. Not set by the web app.
Returns 200 OK · application/json
-
countintegerNumber of matching wallets.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries service: "hushxima". Retry after a short wait; the failure is on the marketplace side. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.hushxima.getCatalogCount(params) src/lib/proxima/endpoints/hushxima.ts
Retrieve catalog facets
/marketplace/catalog/facets Returns the bounds, histograms and taxonomy used to build the catalog filters.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
chainenum RequiredMarketplace chain slug.Possible valuessolanaethereumbscbaserobinhoodarc
Returns 200 OK · application/json
-
countintegerNumber of wallets in the catalog for the chain. -
max_balancestringHighest native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
max_pricestringHighest sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string. -
max_txintegerHighest transaction count. -
max_age_daysintegerOldest wallet age, in days. -
balance_histarray<integer>Wallet counts per balance bucket. -
tx_histarray<integer>Wallet counts per transaction-count bucket. -
price_histarray<integer>Wallet counts per price bucket. -
age_histarray<integer>Wallet counts per age bucket. -
tiersarray<string>Activity tiers present, e.g.tier0. -
personasarray<string>Activity personas present. -
timezonesarray<string>Activity timezone slugs present.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries service: "hushxima". Retry after a short wait; the failure is on the marketplace side. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.hushxima.getCatalogFacets(chain) src/lib/proxima/endpoints/hushxima.ts
List funding sources
/marketplace/catalog/sources Returns the funding venues present in the catalog for a chain.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
chainenum RequiredMarketplace chain slug.Possible valuessolanaethereumbscbaserobinhoodarc
Returns 200 OK · application/json
-
sourcesarray<string>Funding venue slugs, usable in thesourcescatalog filter.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries service: "hushxima". Retry after a short wait; the failure is on the marketplace side. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.hushxima.getSources(chain) src/lib/proxima/endpoints/hushxima.ts
Retrieve native token prices
/marketplace/prices Returns the current USD price of each chain's native token.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
The web app uses these prices to value token holdings in native units. It reads the ethereum price for Robinhood and treats Arc's native token as worth 1 USD.
Parameters
No parameters.
Returns 200 OK · application/json
-
solananumber | nullUSD price of SOL. -
ethereumnumber | nullUSD price of ETH. -
bscnumber | nullUSD price of BNB. -
basenumber | nullUSD price of ETH on Base.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries service: "hushxima". Retry after a short wait; the failure is on the marketplace side. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.hushxima.getPrices() src/lib/proxima/endpoints/hushxima.ts