Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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.

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

  • id string
    Marketplace wallet id (UUID). Pass it in wallet_ids when you create a quote.
  • pubkey string
    Wallet address. The API withholds it from catalog listings; it becomes readable on quote and purchase wallet lines once the wallet is yours.
  • network string
    Network family the wallet belongs to.
  • chain string | null
    Marketplace chain slug, e.g. solana.
  • status string
    Listing status reported by the marketplace.
  • balance string
    Native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • tx_count integer
    Number of on-chain transactions.
  • funded_at string | null
    When the wallet was first funded (RFC 3339).
  • first_tx_at string | null
    First on-chain activity (RFC 3339).
  • last_tx_at string | null
    Latest on-chain activity (RFC 3339).
  • created_at string
    When the marketplace created the wallet (RFC 3339).
  • funding_source string | null
    Funding provider slug.
  • funding_exchange string | null
    Exchange behind a CEX-funded wallet, e.g. binance. The web app shows it in preference to funding_source.
  • sold_at string | null
    When the wallet was sold (RFC 3339).
  • source_kind string | null
    Funding kind. The web app falls back to it when no funding source or exchange is set.
  • tier string | null
    Activity tier: tier0 (funding only), tier1 (light on-chain history), tier2 (activity plus token holdings).
  • persona_name string | null
    Activity persona, e.g. conservative_retail, active_trader, defi_power_user, long_term_holder.
  • timezone_name string | null
    Timezone slug the wallet's activity follows, e.g. americas_et_evening or asia_jst_evening.
  • user_price string | null
    Current 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_holdings array<object> | null
    Tokens the wallet holds, with their USD value.
    Child attributes 6
    • mint string
      Token mint or contract address.
    • symbol string | null
      Token symbol, when known.
    • decimals integer | null
      Token decimals.
    • balance string
      Raw token balance as an integer string. Divide by 10^decimals (and apply ui_multiplier) for display.
    • ui_multiplier string | null
      Display multiplier scaled by 1e18, for tokens whose UI amount differs from the raw amount.
    • usd_value number | null
      USD value of the holding.

List catalog wallets

Bearer JWT beta
GET /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

  • chain enum Required
    Marketplace chain slug. These are marketplace slugs, not Proxima chain ids.
    Possible values solanaethereumbscbaserobinhoodarc
  • count integer Optional
    Page size. The web app requests 500.
  • cursor string | null Optional
    Cursor from a previous page's next_cursor.
  • min_balance string Optional
    Minimum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • max_balance string Optional
    Maximum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • min_price string Optional
    Minimum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • max_price string Optional
    Maximum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • min_age_days integer Optional
    Minimum wallet age, in days. The web app defaults to 1.
  • max_age_days integer Optional
    Maximum wallet age, in days.
  • min_tx_count integer Optional
    Minimum number of on-chain transactions.
  • max_tx_count integer Optional
    Maximum number of on-chain transactions.
  • sources string Optional
    Comma-separated funding sources, as returned by List funding sources.
    Examplebinance,kucoin
  • tier string Optional
    Comma-separated activity tiers, e.g. tier0,tier1.
  • persona string Optional
    Activity persona, e.g. active_trader. Not set by the web app.
  • timezone string Optional
    Comma-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_seconds integer Optional
    Minimum spacing, in seconds, between wallet funding timestamps. The web app defaults to 1800 (30 minutes) to limit funding-time clustering.
  • gap_with string Optional
    Comma-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 with min_funding_gap_seconds.
  • sort string Optional
    Sort field. Not set by the web app.
  • order string Optional
    Sort direction. Not set by the web app.

Returns 200 OK · application/json

Returns a page of Catalog wallet objects.

  • items array<object>
    Wallets on this page. See Catalog wallet.
  • next_cursor string | null
    Cursor for the next page; null on the last page.

Errors

StatusCodeWhen 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

Bearer JWT beta
GET /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

  • chain enum Required
    Marketplace chain slug. These are marketplace slugs, not Proxima chain ids.
    Possible values solanaethereumbscbaserobinhoodarc
  • min_balance string Optional
    Minimum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • max_balance string Optional
    Maximum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • min_price string Optional
    Minimum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • max_price string Optional
    Maximum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • min_age_days integer Optional
    Minimum wallet age, in days. The web app defaults to 1.
  • max_age_days integer Optional
    Maximum wallet age, in days.
  • min_tx_count integer Optional
    Minimum number of on-chain transactions.
  • max_tx_count integer Optional
    Maximum number of on-chain transactions.
  • sources string Optional
    Comma-separated funding sources, as returned by List funding sources.
    Examplebinance,kucoin
  • tier string Optional
    Comma-separated activity tiers, e.g. tier0,tier1.
  • persona string Optional
    Activity persona, e.g. active_trader. Not set by the web app.
  • timezone string Optional
    Comma-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_seconds integer Optional
    Minimum spacing, in seconds, between wallet funding timestamps. The web app defaults to 1800 (30 minutes) to limit funding-time clustering.
  • gap_with string Optional
    Comma-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 with min_funding_gap_seconds.
  • sort string Optional
    Sort field. Not set by the web app.
  • order string Optional
    Sort direction. Not set by the web app.

Returns 200 OK · application/json

  • count integer
    Number of matching wallets.

Errors

StatusCodeWhen 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

Bearer JWT beta
GET /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

  • chain enum Required
    Marketplace chain slug.
    Possible values solanaethereumbscbaserobinhoodarc

Returns 200 OK · application/json

  • count integer
    Number of wallets in the catalog for the chain.
  • max_balance string
    Highest native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • max_price string
    Highest sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.
  • max_tx integer
    Highest transaction count.
  • max_age_days integer
    Oldest wallet age, in days.
  • balance_hist array<integer>
    Wallet counts per balance bucket.
  • tx_hist array<integer>
    Wallet counts per transaction-count bucket.
  • price_hist array<integer>
    Wallet counts per price bucket.
  • age_hist array<integer>
    Wallet counts per age bucket.
  • tiers array<string>
    Activity tiers present, e.g. tier0.
  • personas array<string>
    Activity personas present.
  • timezones array<string>
    Activity timezone slugs present.

Errors

StatusCodeWhen 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

Bearer JWT beta
GET /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

  • chain enum Required
    Marketplace chain slug.
    Possible values solanaethereumbscbaserobinhoodarc

Returns 200 OK · application/json

  • sources array<string>
    Funding venue slugs, usable in the sources catalog filter.

Errors

StatusCodeWhen 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

GET /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

  • solana number | null
    USD price of SOL.
  • ethereum number | null
    USD price of ETH.
  • bsc number | null
    USD price of BNB.
  • base number | null
    USD price of ETH on Base.

Errors

StatusCodeWhen 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