# 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](#list-catalog-wallets) to page through wallets that match a filter and [Count catalog wallets](#count-catalog-wallets) for the matching total. [Retrieve catalog facets](#retrieve-catalog-facets) and [List funding sources](#list-funding-sources) feed the filter controls. Selected wallet ids then go into a quote — see [Marketplace orders](/reference/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.

Base URL: `https://api-mig.proxima.tools`

## Endpoints

- `GET /marketplace/catalog`: List catalog wallets
- `GET /marketplace/catalog/count`: Count catalog wallets
- `GET /marketplace/catalog/facets`: Retrieve catalog facets
- `GET /marketplace/catalog/sources`: List funding sources
- `GET /marketplace/prices`: Retrieve native token prices

## 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.

- `id` (string): Marketplace wallet id (UUID). Pass it in `wallet_ids` when you [create a quote](/reference/marketplace-orders/#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.
  - `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.

```json
{
  "id": "9fb9b985-594c-42e9-9592-fb986f90badb",
  "network": "svm",
  "chain": "solana",
  "status": "listed",
  "balance": "41250000",
  "tx_count": 14,
  "funded_at": "2026-08-14T09:21:07Z",
  "first_tx_at": "2026-08-14T11:02:44Z",
  "last_tx_at": "2026-10-29T18:40:12Z",
  "created_at": "2026-08-13T22:10:00Z",
  "funding_source": "husher",
  "funding_exchange": "binance",
  "sold_at": null,
  "source_kind": "cex",
  "tier": "tier1",
  "persona_name": "active_trader",
  "timezone_name": "europe_cet_evening",
  "user_price": "135000000",
  "token_holdings": [
    {
      "mint": "1kF6kS9Z9RitRBAbgT6LzzxDrdr8odsxtqfEE7PWRCF",
      "symbol": "DEMO",
      "decimals": 6,
      "balance": "1520000000",
      "ui_multiplier": null,
      "usd_value": 0.84
    }
  ]
}
```

### List catalog wallets

`GET /marketplace/catalog`

Returns a page of wallets for sale that match the filters. (Bearer JWT · beta)

- 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: `solana`, `ethereum`, `bsc`, `base`, `robinhood`, `arc`.
- `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](#list-funding-sources).
- `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

Returns a page of [Catalog wallet](#object-catalog-wallet) objects.

- `items` (array<object>): Wallets on this page. See [Catalog wallet](#object-catalog-wallet).
- `next_cursor` (string | null): Cursor for the next page; `null` on the last page.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/marketplace/catalog?chain=solana&sources=binance%2Ckucoin" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "items": [
    {
      "id": "9fb9b985-594c-42e9-9592-fb986f90badb",
      "network": "svm",
      "chain": "solana",
      "status": "listed",
      "balance": "41250000",
      "tx_count": 14,
      "funded_at": "2026-08-14T09:21:07Z",
      "first_tx_at": "2026-08-14T11:02:44Z",
      "last_tx_at": "2026-10-29T18:40:12Z",
      "created_at": "2026-08-13T22:10:00Z",
      "funding_source": "husher",
      "funding_exchange": "binance",
      "sold_at": null,
      "source_kind": "cex",
      "tier": "tier1",
      "persona_name": "active_trader",
      "timezone_name": "europe_cet_evening",
      "user_price": "135000000",
      "token_holdings": [
        {
          "mint": "1kF6kS9Z9RitRBAbgT6LzzxDrdr8odsxtqfEE7PWRCF",
          "symbol": "DEMO",
          "decimals": 6,
          "balance": "1520000000",
          "ui_multiplier": null,
          "usd_value": 0.84
        }
      ]
    }
  ],
  "next_cursor": "eyJpZCI6IjlmYjliOTg1In0"
}
```

### Count catalog wallets

`GET /marketplace/catalog/count`

Returns how many wallets match the filters. (Bearer JWT · beta)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Takes the same filters as [List catalog wallets](#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: `solana`, `ethereum`, `bsc`, `base`, `robinhood`, `arc`.
- `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](#list-funding-sources).
- `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

- `count` (integer): Number of matching wallets.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/marketplace/catalog/count?chain=solana&sources=binance%2Ckucoin" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "count": 1284
}
```

### Retrieve catalog facets

`GET /marketplace/catalog/facets`

Returns the bounds, histograms and taxonomy used to build the catalog filters. (Bearer JWT · beta)

- 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: `solana`, `ethereum`, `bsc`, `base`, `robinhood`, `arc`.

#### Returns 200 OK

- `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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/marketplace/catalog/facets?chain=solana" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "count": 1284,
  "max_balance": "2500000000",
  "max_price": "900000000",
  "max_tx": 312,
  "max_age_days": 420,
  "balance_hist": [
    210,
    188,
    140,
    96,
    51,
    22,
    9,
    3
  ],
  "tx_hist": [
    402,
    311,
    220,
    140,
    98,
    61,
    30,
    22
  ],
  "price_hist": [
    96,
    230,
    301,
    270,
    188,
    120,
    52,
    27
  ],
  "age_hist": [
    18,
    77,
    160,
    254,
    300,
    251,
    150,
    74
  ],
  "tiers": [
    "tier0",
    "tier1",
    "tier2"
  ],
  "personas": [
    "active_trader",
    "long_term_holder"
  ],
  "timezones": [
    "americas_et_evening",
    "europe_cet_evening",
    "asia_jst_evening"
  ]
}
```

### List funding sources

`GET /marketplace/catalog/sources`

Returns the funding venues present in the catalog for a chain. (Bearer JWT · beta)

- 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: `solana`, `ethereum`, `bsc`, `base`, `robinhood`, `arc`.

#### Returns 200 OK

- `sources` (array<string>): Funding venue slugs, usable in the `sources` catalog filter.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/marketplace/catalog/sources?chain=solana" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "sources": [
    "binance",
    "bybit",
    "kucoin",
    "mexc"
  ]
}
```

### Retrieve native token prices

`GET /marketplace/prices`

Returns the current USD price of each chain's native token. (Bearer JWT · beta)

- 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.

#### Returns 200 OK

- `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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/marketplace/prices" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "solana": 182.41,
  "ethereum": 3520.18,
  "bsc": 612.3,
  "base": 3520.18
}
```
