# Market Overview

> Read daily on-chain activity per chain and per launchpad, and the daily trench score.

The Market Overview endpoints serve daily market statistics: transactions, active wallets and DEX volume per chain, tokens launched and volume per launchpad, launchpad revenue, and a 0-100 **trench score** of overall memecoin activity. The data comes from tehcscreener.com and is credited as such in the app.

Every series is a list of `YYYY-MM-DD` days with values aligned by index. `through` is the latest day in a dataset; the app counts its 1d, 7d and 30d windows back from it. Chains and launchpads use the data provider's identifiers (`solana`, `bnb`, `pumpfun`, `letsbonk`, ...), not Proxima chain IDs.

In the web app these endpoints feed the **Market Overview** panel in the bottom bar.

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

## Endpoints

- `GET /market/chains`: List market chains
- `GET /market/chains/{chain}`: Retrieve chain activity
- `GET /market/launchpads`: List launchpad activity
- `GET /market/launchpads/{chain}/{pad}`: Retrieve launchpad activity
- `GET /market/launchpads/{chain}/{pad}/revenue`: Retrieve launchpad revenue
- `GET /market/trench`: Retrieve the trench score

### List market chains

`GET /market/chains`

Lists the chains covered by the market data. (Bearer JWT)

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

The SDK returns the `chains` array. The app keeps only chains it supports, then fetches each chain's series.

#### Returns 200 OK

- `chains` (array<object>): Covered chains.
  - `chain` (string): Provider chain identifier, e.g. `solana`, `bnb`, `ethereum`, `base`.
  - `display_name` (string): Human-readable chain name.
  - `through` (string): Latest day with data (`YYYY-MM-DD`).

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `tehcscreener api issue: <error>` | tehcscreener failed and the backend holds no cached copy of this dataset. | Retry in a few minutes. |

#### Example request

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

#### Example response

```json
{
  "chains": [
    {
      "chain": "solana",
      "display_name": "Solana",
      "through": "2026-11-01"
    },
    {
      "chain": "bnb",
      "display_name": "BNB Chain",
      "through": "2026-11-01"
    },
    {
      "chain": "base",
      "display_name": "Base",
      "through": "2026-11-01"
    }
  ]
}
```

### Retrieve chain activity

`GET /market/chains/{chain}`

Returns daily transactions, active wallets and DEX volume for one chain. (Bearer JWT)

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

#### Path parameters

- `chain` (string, required): Provider chain identifier from [List market chains](#list-chains).

#### Returns 200 OK

- `chain` (string): Provider chain identifier.
- `through` (string): Latest day with data.
- `days` (array<string>): Days of the series (`YYYY-MM-DD`).
- `txns` (array<number>): Transactions per day.
- `active_wallets` (array<number>): Active wallets per day.
- `dex_volume_usd` (array<number>): DEX volume in USD per day.
- `dex_trades` (array<number>): DEX trades per day.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid id: <chain>` | `chain` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`. | Use a chain ID from [List market chains](/reference/market/#list-chains). |
| 404 | `not_found` | `no market data` | The data provider has no data for this chain. | Use a chain ID from [List market chains](/reference/market/#list-chains). |
| 422 | `upstream_failure` | `tehcscreener api issue: <error>` | tehcscreener failed and the backend holds no cached copy of this dataset. | Retry in a few minutes. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/market/chains/solana" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "chain": "solana",
  "through": "2026-11-01",
  "days": [
    "2026-10-30",
    "2026-10-31",
    "2026-11-01"
  ],
  "txns": [
    81244310,
    79310022,
    83102877
  ],
  "active_wallets": [
    4120331,
    3988214,
    4211907
  ],
  "dex_volume_usd": [
    3812440120.4,
    3655201988.1,
    4022118733.9
  ],
  "dex_trades": [
    21330442,
    20877120,
    22410093
  ]
}
```

### List launchpad activity

`GET /market/launchpads`

Returns daily volume and tokens launched for every covered launchpad. (Bearer JWT)

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

All series share the top-level `days` axis.

#### Returns 200 OK

- `through` (string): Latest day with data.
- `days` (array<string>): Days shared by every series (`YYYY-MM-DD`).
- `series` (array<object>): One series per launchpad.
  - `chain` (string): Provider chain identifier.
  - `pad` (string): Provider launchpad identifier, e.g. `pumpfun`, `letsbonk`, `ponsfamily.com`.
  - `volume_usd` (array<number>): Volume in USD per day.
  - `tokens_launched` (array<number>): Tokens created per day.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `tehcscreener api issue: <error>` | tehcscreener failed and the backend holds no cached copy of this dataset. | Retry in a few minutes. |

#### Example request

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

#### Example response

```json
{
  "through": "2026-11-01",
  "days": [
    "2026-10-30",
    "2026-10-31",
    "2026-11-01"
  ],
  "series": [
    {
      "chain": "solana",
      "pad": "pumpfun",
      "volume_usd": [
        402118320.5,
        388220193.2,
        421003877
      ],
      "tokens_launched": [
        23110,
        22870,
        24180
      ]
    },
    {
      "chain": "solana",
      "pad": "letsbonk",
      "volume_usd": [
        18220331,
        17110290.4,
        19004112.8
      ],
      "tokens_launched": [
        1320,
        1288,
        1402
      ]
    }
  ]
}
```

### Retrieve launchpad activity

`GET /market/launchpads/{chain}/{pad}`

Returns daily tokens launched, volume and trades for one launchpad. (Bearer JWT)

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

Called when a launchpad is selected in the Market Overview panel.

#### Path parameters

- `chain` (string, required): Provider chain identifier.
- `pad` (string, required): Provider launchpad identifier. URL-encoded by the SDK.

#### Returns 200 OK

- `chain` (string): Provider chain identifier.
- `pad` (string): Provider launchpad identifier.
- `daily` (array<object>): One entry per day.
  - `day` (string): Day (`YYYY-MM-DD`).
  - `tokens_launched` (number): Tokens created that day.
  - `volume_usd` (number): Volume in USD.
  - `trade_txns` (number): Trade transactions.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid id: <id>` | `chain` or `pad` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`. | Use an identifier from [List market chains](/reference/market/#list-chains) or [List launchpad activity](/reference/market/#list-launchpads). |
| 404 | `not_found` | `no market data` | The data provider has no data for this launchpad. | Use a launchpad from [List launchpad activity](/reference/market/#list-launchpads). |
| 422 | `upstream_failure` | `tehcscreener api issue: <error>` | tehcscreener failed and the backend holds no cached copy of this dataset. | Retry in a few minutes. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/market/launchpads/solana/pumpfun" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "chain": "solana",
  "pad": "pumpfun",
  "daily": [
    {
      "day": "2026-10-31",
      "tokens_launched": 22870,
      "volume_usd": 388220193.2,
      "trade_txns": 8812044
    },
    {
      "day": "2026-11-01",
      "tokens_launched": 24180,
      "volume_usd": 421003877,
      "trade_txns": 9120331
    }
  ]
}
```

### Retrieve launchpad revenue

`GET /market/launchpads/{chain}/{pad}/revenue`

Returns daily protocol revenue, creator revenue and buybacks for one launchpad. (Bearer JWT)

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

> A launchpad the data provider has no revenue data for answers `200` with an empty `daily`, not `404`.

#### Path parameters

- `chain` (string, required): Provider chain identifier.
- `pad` (string, required): Provider launchpad identifier. URL-encoded by the SDK.

#### Returns 200 OK

- `daily` (array<object>): One entry per day. Empty when the launchpad has no revenue coverage.
  - `day` (string): Day (`YYYY-MM-DD`).
  - `protocol_revenue_usd` (number): Protocol revenue in USD.
  - `creator_revenue_usd` (number | null): Revenue paid to token creators in USD, or `null` when not tracked for this launchpad.
  - `buyback_usd` (number | null): Buybacks in USD, or `null` when not tracked for this launchpad.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid id: <id>` | `chain` or `pad` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`. | Use an identifier from [List market chains](/reference/market/#list-chains) or [List launchpad activity](/reference/market/#list-launchpads). |
| 422 | `upstream_failure` | `tehcscreener api issue: <error>` | tehcscreener failed and the backend holds no cached copy of this dataset. | Retry in a few minutes. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/market/launchpads/solana/pumpfun/revenue" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "daily": [
    {
      "day": "2026-10-31",
      "protocol_revenue_usd": 1203344.18,
      "creator_revenue_usd": 388120.02,
      "buyback_usd": null
    },
    {
      "day": "2026-11-01",
      "protocol_revenue_usd": 1311870.4,
      "creator_revenue_usd": 402771.95,
      "buyback_usd": null
    }
  ]
}
```

### Retrieve the trench score

`GET /market/trench`

Returns today's trench score with its band, and the daily score history. (Bearer JWT)

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

The score runs from 0 to 100. The app labels its ends **Ded** and **Euphoric** and colors the bands `ded`, `cold`, `active`, `hot` and `euphoric`.

#### Returns 200 OK

- `today` (object | null): Latest score, or `null` when none is available.
  - `day` (string): Day of the score (`YYYY-MM-DD`).
  - `score` (number): Score from 0 to 100.
  - `band` (string): Band label, e.g. `cold`, `active`, `hot`.
- `history` (array<object>): Past daily scores.
  - `day` (string): Day (`YYYY-MM-DD`).
  - `score` (number): Score from 0 to 100.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `tehcscreener api issue: <error>` | tehcscreener failed and the backend holds no cached copy of this dataset. | Retry in a few minutes. |

#### Example request

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

#### Example response

```json
{
  "today": {
    "day": "2026-11-01",
    "score": 62.4,
    "band": "active"
  },
  "history": [
    {
      "day": "2026-10-30",
      "score": 55.1
    },
    {
      "day": "2026-10-31",
      "score": 58.9
    },
    {
      "day": "2026-11-01",
      "score": 62.4
    }
  ]
}
```
