# Datafeed HTTP

> HTTP reads on the market datafeed: coin header stats, the screener, wallet explorer reads, token thumbnails and client telemetry.

The market datafeed serves a few HTTP routes next to its WebSocket (see [Market datafeed](/realtime/datafeed/)). The base URL is the datafeed socket URL with an HTTP(S) scheme and without the trailing `/ws`: `https://datafeed.proxima.tools` in production, `https://datafeed.proximatool.dev` in dev.

These routes do **not** take the Proxima session JWT. They take a short-lived datafeed token issued by the main API, sent as `Authorization: Bearer <token>`:

- **Chart token** (one mint): `GET /charts/{launch_id}/subscribe` on the main API returns `{ ok, chain, mint, token }`. Used for `/symbol`.
- **Unscoped tokens**: `GET /charts/screener/token` and `GET /charts/wallet/token` return `{ token, expires_in }` (300 seconds). The `screener` token opens `/screener` and `/screener/live`; the `wallet` token opens `/wallet/{addr}/*`. The web client caches each token until 60 seconds before its `exp`.

Errors come back as JSON `{ "error": "<code>" }`. On a `401` the web client drops its cached token, fetches a new one and retries once; other `4xx` are not retried.

Chains use the datafeed's spelling: `solana`, `ethereum`, and otherwise the front chain id (`bsc`, `base`, ...). Responses may spell BSC `bnb`.

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

## Endpoints

- `GET https://datafeed.proxima.tools/symbol`: Retrieve symbol stats
- `GET https://datafeed.proxima.tools/screener`: List a screener view
- `GET https://datafeed.proxima.tools/wallet/{addr}/positions`: List wallet positions
- `GET https://datafeed.proxima.tools/wallet/{addr}/trades`: List wallet trades
- `GET https://datafeed.proxima.tools/wallet/{addr}/summary`: Retrieve a wallet summary
- `GET https://datafeed.proxima.tools/wallet/{addr}/balances`: Retrieve wallet balances
- `GET https://datafeed.proxima.tools/wallet/{addr}/daily`: List a wallet's daily activity
- `GET https://datafeed.proxima.tools/img/{chain}/{mint}`: Retrieve a token image
- `POST https://datafeed.proxima.tools/telemetry`: Send datafeed telemetry

## The ScreenerItem object

One coin row in a screener view. Window maps (`Windows`) are keyed `m1`, `m5`, `m30`, `h1`, `h6`, `h24`; `m1` and `m30` can be absent on older rows.

- `chain` (string): Datafeed chain slug.
- `mint` (string): Token mint or contract address.
- `score` (number): Rank score within the view; higher sorts first. Its scale depends on the view.
- `name` (string | null): Token name.
- `symbol` (string | null): Token ticker.
- `image` (string | null): Image URL.
- `launchpad` (string | null): Launchpad that created the coin.
- `launchTs` (integer | null): Launch time, unix seconds.
- `creator` (string | null): Creator address.
- `venue` (string | null): Trading venue.
- `pool` (string | null): Pool address.
- `quote` (string | null): Quote asset.
- `phase` (string | null): Lifecycle phase; the web client falls back to `curve` when absent.
- `curveProgress` (number | null): Bonding-curve progress.
- `priceUsd` (number | null): Price in USD.
- `mcapUsd` (number | null): Market cap in USD.
- `volumeUsd` (object | null): USD volume per window (`Windows`).
- `buyVolumeUsd` (object | null): USD buy volume per window.
- `sellVolumeUsd` (object | null): USD sell volume per window.
- `trades` (object | null): Trade count per window.
- `buys` (object | null): Buy count per window.
- `sells` (object | null): Sell count per window.
- `makers` (object | null): Distinct traders per window.
- `priceChange` (object | null): Price move per window, in percent; any window may be `null`.
- `makersCapped` (boolean): `makers` hit a counting cap.
- `holders` (integer | null): Holder count.
- `holdersCapped` (boolean): `holders` hit a counting cap.
- `top10Pct` (number | null): Share of supply held by the top 10 holders, percent.
- `snipers` (integer | null): Sniper count.
- `bundlePct` (number | null): Share of supply the creation-block buyers (creator aside) still hold, percent.
- `lastTradeAt` (integer | null): Time of the last trade (unix seconds; unit inferred).
- `terminals` (object): Map of trading terminal name to a count.
- `updatedAt` (integer | null): Last refresh time of the row (unix seconds; unit inferred).
- `tax` (object | null): `{ buyBps, sellBps, venue: { buy, sell } | null, transferFeeBps }`; `buy`/`sell` split fees into `lp`, `protocol`, `creator`, `tax`, `total`.
- `facts` (object | null): On-chain token facts: `name`, `symbol`, `uri`, `program`, `mintAuthorityRevoked`, `freezeAuthorityRevoked`, `transferFeeBps`, `transferHook`, `final`, `readAt`.
- `socials` (object): `{ website, twitter, telegram }`, each nullable.
- `dev` (object | null): Creator track record: `launched`, `migrated`, `checked`, `since` (date string), `holdingPct`, `sold`.

```json
{
  "chain": "solana",
  "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "score": 1532.4,
  "name": "Moon Cat",
  "symbol": "MCAT",
  "image": "https://img.proxima.tools/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG",
  "launchpad": "pumpfun",
  "launchTs": 1761998400,
  "creator": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "venue": "pumpfun",
  "pool": null,
  "quote": "So11111111111111111111111111111111111111112",
  "phase": "curve",
  "curveProgress": 42.7,
  "priceUsd": 0.0000123,
  "mcapUsd": 12300,
  "volumeUsd": {
    "m1": 120,
    "m5": 840,
    "m30": 3100,
    "h1": 3100,
    "h6": 3100,
    "h24": 3100
  },
  "buyVolumeUsd": {
    "m5": 600,
    "h1": 2200,
    "h6": 2200,
    "h24": 2200
  },
  "sellVolumeUsd": {
    "m5": 240,
    "h1": 900,
    "h6": 900,
    "h24": 900
  },
  "trades": {
    "m5": 31,
    "h1": 112,
    "h6": 112,
    "h24": 112
  },
  "buys": {
    "m5": 22,
    "h1": 80,
    "h6": 80,
    "h24": 80
  },
  "sells": {
    "m5": 9,
    "h1": 32,
    "h6": 32,
    "h24": 32
  },
  "makers": {
    "m5": 18,
    "h1": 61,
    "h6": 61,
    "h24": 61
  },
  "priceChange": {
    "m5": 12.5,
    "h1": 48.1,
    "h6": null,
    "h24": null
  },
  "makersCapped": false,
  "holders": 57,
  "holdersCapped": false,
  "top10Pct": 31.2,
  "snipers": 2,
  "bundlePct": 4.1,
  "lastTradeAt": 1762001940,
  "terminals": {
    "axiom": 12,
    "photon": 4
  },
  "updatedAt": 1762001941,
  "tax": null,
  "facts": null,
  "socials": {
    "website": null,
    "twitter": "https://x.com/mooncat",
    "telegram": null
  },
  "dev": {
    "launched": 3,
    "migrated": 1,
    "checked": 3,
    "since": "2026-09-14",
    "holdingPct": 2.5,
    "sold": false
  }
}
```

## The WalletPosition object

A wallet's position in one token, as the wallet explorer lists it.

- `chain` (string | null): Datafeed chain slug.
- `mint` (string): Token address.
- `name` (string | null): Token name.
- `symbol` (string | null): Token ticker.
- `image` (string | null): Image URL.
- `balance` (number | null): Current token balance.
- `balanceSource` (enum): Whether `balance` was read on chain or derived from trades. Possible values: `onchain`, `trades`.
- `boughtToken` (number): Tokens bought.
- `boughtUsd` (number): USD spent buying.
- `buys` (integer): Buy count.
- `soldToken` (number): Tokens sold.
- `soldUsd` (number): USD received selling.
- `sells` (integer): Sell count.
- `avgBuyPriceUsd` (number | null): Average buy price, USD.
- `avgSellPriceUsd` (number | null): Average sell price, USD.
- `realizedPnlUsd` (number | null): Realized PnL, USD.
- `remainingToken` (number): Tokens still held by trade accounting.
- `unrealizedPnlUsd` (number | null): Unrealized PnL, USD.
- `totalPnlUsd` (number | null): Realized plus unrealized PnL, USD.
- `priceUsd` (number | null): Current price, USD.
- `priceSource` (enum | null): Where `priceUsd` came from. Possible values: `screener`, `swap`.
- `priceAt` (integer | null): Time of `priceUsd` (unix seconds; unit inferred).
- `valueUsd` (number | null): Position value, USD.
- `firstBuyAt` (integer | null): Time of the first buy (unix seconds; unit inferred).
- `lastActivityAt` (integer): Time of the last trade, unix seconds.

```json
{
  "chain": "solana",
  "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "name": "Moon Cat",
  "symbol": "MCAT",
  "image": null,
  "balance": 1250000,
  "balanceSource": "onchain",
  "boughtToken": 2000000,
  "boughtUsd": 18.4,
  "buys": 2,
  "soldToken": 750000,
  "soldUsd": 21.9,
  "sells": 1,
  "avgBuyPriceUsd": 0.0000092,
  "avgSellPriceUsd": 0.0000292,
  "realizedPnlUsd": 15,
  "remainingToken": 1250000,
  "unrealizedPnlUsd": 3.9,
  "totalPnlUsd": 18.9,
  "priceUsd": 0.0000123,
  "priceSource": "screener",
  "priceAt": 1762001941,
  "valueUsd": 15.4,
  "firstBuyAt": 1761998460,
  "lastActivityAt": 1762000210
}
```

## The WalletTrade object

One swap by a wallet.

- `ts` (integer): Trade time, unix seconds.
- `chain` (string | null): Datafeed chain slug.
- `mint` (string): Token address.
- `symbol` (string | null): Token ticker.
- `image` (string | null): Image URL.
- `side` (string): `buy` or `sell`.
- `tokenAmount` (number): Token amount.
- `quoteAmount` (number | null): Quote amount.
- `quoteSymbol` (string | null): Quote ticker.
- `quoteAddress` (string | null): Quote token address.
- `priceUsd` (number | null): Token price at the trade, USD.
- `volumeUsd` (number | null): Trade size, USD.
- `signature` (string): Transaction signature or hash.
- `innerIndex` (integer): Index of the swap inside the transaction.
- `platform` (string | null): Platform.
- `venue` (string | null): Venue.
- `poolId` (string | null): Pool address.
- `terminal` (string): Trading terminal label, when detected.
- `terminalConfidence` (string): Confidence of the terminal label.
- `terminalStale` (boolean): Terminal label is stale.

```json
{
  "ts": 1762000210,
  "chain": "solana",
  "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "symbol": "MCAT",
  "image": null,
  "side": "sell",
  "tokenAmount": 750000,
  "quoteAmount": 0.117,
  "quoteSymbol": "SOL",
  "quoteAddress": "So11111111111111111111111111111111111111112",
  "priceUsd": 0.0000292,
  "volumeUsd": 21.9,
  "signature": "5h8Fq3mTzW1rVvJ6Yk2pS9cX4bN7dL3eG8aH1jK6uM2nP5qR9sT4vW7xY2zA3bC6dE8fG1hJ4kL7mN9pQ2rS5tU",
  "innerIndex": 0,
  "platform": "pumpfun",
  "venue": "pumpfun",
  "poolId": null,
  "terminal": "axiom"
}
```

### Retrieve symbol stats

`GET https://datafeed.proxima.tools/symbol`

Returns a coin's header figures: supply, transaction count, per-window buys and sells, and price changes. (No auth · beta)

- Token: None. This endpoint is public.
- Retry: Safe to retry.

Called once the datafeed socket has authenticated the mint, with the same chart token. The web client uses `supply` as the circulating supply for market-cap charts.

#### Query parameters

- `mint` (string, required): Token mint or contract address.

#### Headers

- `Authorization` (string, required): `Bearer <chart token>` for this mint, from `GET /charts/{launch_id}/subscribe` on the main API.

#### Returns 200 OK

- `mint` (string): Token address.
- `chain` (string): Datafeed chain slug.
- `symbol` (string | null): Ticker.
- `name` (string | null): Token name.
- `supply` (number | null): Token supply.
- `totalTxCount` (integer | null): Total transaction count.
- `windows` (object): Keys `m5`, `h1`, `h4`, `h24`; each `null` where the producer's row does not state it.
  - `{window}` (object | null): Trades over one window, keyed `m5`, `h1`, `h4` or `h24`. `null` where the producer row does not state it.
    - `buys` (integer): Buy count.
    - `sells` (integer): Sell count.
    - `buyVolumeUsd` (number): Buy volume, USD.
    - `sellVolumeUsd` (number): Sell volume, USD.
- `priceChange` (object): Keys `m5`, `h1`, `h4`, `h24`: price change in percent, or `null`.
- `updatedAt` (integer | null): Last refresh time (unit not visible from the client).

#### Example request

```bash
curl "https://datafeed.proxima.tools/symbol?mint=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
```

#### Example response

```json
{
  "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "chain": "solana",
  "symbol": "MCAT",
  "name": "Moon Cat",
  "supply": 1000000000,
  "totalTxCount": 412,
  "windows": {
    "m5": {
      "buys": 22,
      "sells": 9,
      "buyVolumeUsd": 600,
      "sellVolumeUsd": 240
    },
    "h1": {
      "buys": 80,
      "sells": 32,
      "buyVolumeUsd": 2200,
      "sellVolumeUsd": 900
    },
    "h4": {
      "buys": 80,
      "sells": 32,
      "buyVolumeUsd": 2200,
      "sellVolumeUsd": 900
    },
    "h24": null
  },
  "priceChange": {
    "m5": 12.5,
    "h1": 48.1,
    "h4": 48.1,
    "h24": null
  },
  "updatedAt": 1762001941
}
```

### List a screener view

`GET https://datafeed.proxima.tools/screener`

Returns one page of a screener ranking across one or more chains. (No auth · beta)

- Token: None. This endpoint is public.
- Retry: Safe to retry.

Defined in the web client as `useScreener` (100 items per page, refetched every 4 seconds), but the screener pages currently read the live socket `/screener/live` instead (see [Market datafeed](/realtime/datafeed/)). Screener features are only enabled for admins, behind a feature flag that is on by default in development.

#### Query parameters

- `chains` (string, required): Comma-separated datafeed chain slugs.
- `view` (string, required): `new`, `trending`, `graduating`, `migrated`, `mcap`, or a discover ranking `<metric>_<window>` with metric `volume`, `txns`, `mcapchange`, `mcapchangepct` and window `m1`, `m5`, `m30`, `h1`, `h24`.
- `limit` (integer, optional): Page size. The web client sends 100.
- `cursor` (string, optional): `next` from the previous page.

#### Headers

- `Authorization` (string, required): `Bearer <screener token>` from `GET /charts/screener/token`.

#### Returns 200 OK

- `view` (string): Echoed view.
- `chains` (array<string>): Echoed chains.
- `items` (array<object>): `ScreenerItem` rows, best first.
- `next` (string | null): Cursor for the next page, `null` at the end.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 401 |  |  | Screener token missing, expired or rejected. The web client fetches a new token and retries once. | Fetch a new screener token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once. |

#### Example request

```bash
curl "https://datafeed.proxima.tools/screener?chains=solana%2Cbsc&view=volume_h1&limit=100"
```

#### Example response

```json
{
  "view": "new",
  "chains": [
    "solana"
  ],
  "items": [
    {
      "chain": "solana",
      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "score": 1761998400,
      "name": "Moon Cat",
      "symbol": "MCAT",
      "image": null,
      "mcapUsd": 12300,
      "priceUsd": 0.0000123
    }
  ],
  "next": "eyJvIjoxMDB9"
}
```

### List wallet positions

`GET https://datafeed.proxima.tools/wallet/{addr}/positions`

Returns a wallet's token positions with cost basis and PnL. (No auth · beta)

- Token: None. This endpoint is public.
- Retry: Safe to retry.

Used by the wallet explorer (behind a feature flag) with 50 items per page, sorted by value.

#### Path parameters

- `addr` (string, required): Wallet address.

#### Query parameters

- `chain` (string, optional): Datafeed chain slug.
- `sort` (enum, optional): Sort order. The web client sends `value`. Possible values: `value`, `activity`.
- `limit` (integer, optional): Page size. The web client sends 50.
- `cursor` (string, optional): `next` from the previous page.

#### Headers

- `Authorization` (string, required): `Bearer <wallet token>` from `GET /charts/wallet/token`.

#### Returns 200 OK

- `addr` (string): Echoed wallet.
- `chain` (string | null): Echoed chain.
- `open` (boolean): Whether only open positions are listed.
- `sort` (enum): Applied sort. Possible values: `value`, `activity`.
- `items` (array<object>): `WalletPosition` rows.
- `next` (string | null): Cursor for the next page.
- `truncated` (boolean): The datafeed stopped before reading the wallet's full history.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 401 |  |  | Wallet token missing, expired or rejected. The web client fetches a new token and retries once. | Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once. |

#### Example request

```bash
curl "https://datafeed.proxima.tools/wallet/9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM/positions?chain=solana&limit=50"
```

#### Example response

```json
{
  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "chain": "solana",
  "open": true,
  "sort": "value",
  "items": [
    {
      "chain": "solana",
      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "symbol": "MCAT",
      "balance": 1250000,
      "balanceSource": "onchain",
      "valueUsd": 15.4,
      "totalPnlUsd": 18.9,
      "lastActivityAt": 1762000210
    }
  ],
  "next": null,
  "truncated": false
}
```

### List wallet trades

`GET https://datafeed.proxima.tools/wallet/{addr}/trades`

Returns a wallet's swaps, newest first, optionally for one token. (No auth · beta)

- Token: None. This endpoint is public.
- Retry: Safe to retry.

#### Path parameters

- `addr` (string, required): Wallet address.

#### Query parameters

- `chain` (string, optional): Datafeed chain slug.
- `mint` (string, optional): Restrict to one token.
- `limit` (integer, optional): Page size. The web client sends 50.
- `before` (string, optional): `next` from the previous page.

#### Headers

- `Authorization` (string, required): `Bearer <wallet token>` from `GET /charts/wallet/token`.

#### Returns 200 OK

- `addr` (string): Echoed wallet.
- `chain` (string | null): Echoed chain.
- `mint` (string | null): Echoed mint filter.
- `items` (array<object>): `WalletTrade` rows.
- `next` (string | null): Value for `before` on the next page.
- `truncated` (boolean): The datafeed stopped before reading the wallet's full history.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 401 |  |  | Wallet token missing, expired or rejected. The web client fetches a new token and retries once. | Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once. |

#### Example request

```bash
curl "https://datafeed.proxima.tools/wallet/9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM/trades?chain=solana&limit=50"
```

#### Example response

```json
{
  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "chain": "solana",
  "mint": null,
  "items": [
    {
      "ts": 1762000210,
      "chain": "solana",
      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "symbol": "MCAT",
      "side": "sell",
      "tokenAmount": 750000,
      "volumeUsd": 21.9,
      "signature": "5h8Fq3mTzW1rVvJ6Yk2pS9cX4bN7dL3eG8aH1jK6uM2nP5qR9sT4vW7xY2zA3bC6dE8fG1hJ4kL7mN9pQ2rS5tU",
      "innerIndex": 0
    }
  ],
  "next": "b3BhcXVlLWN1cnNvcg",
  "truncated": false
}
```

### Retrieve a wallet summary

`GET https://datafeed.proxima.tools/wallet/{addr}/summary`

Returns a wallet's trading totals over 1, 7 and 30 days. (No auth · beta)

- Token: None. This endpoint is public.
- Retry: Safe to retry.

#### Path parameters

- `addr` (string, required): Wallet address.

#### Query parameters

- `chain` (string, optional): Datafeed chain slug.

#### Headers

- `Authorization` (string, required): `Bearer <wallet token>` from `GET /charts/wallet/token`.

#### Returns 200 OK

- `addr` (string): Echoed wallet.
- `chain` (string | null): Echoed chain.
- `windows` (object): Keys `1d`, `7d`, `30d` (each optional).
  - `{window}` (object): Activity over one window, keyed `1d`, `7d` or `30d`.
    - `volumeUsd` (number): Total volume, USD.
    - `buyVolumeUsd` (number): Buy volume, USD.
    - `sellVolumeUsd` (number): Sell volume, USD.
    - `trades` (integer): Trade count.
    - `buys` (integer): Buy count.
    - `sells` (integer): Sell count.
    - `tokens` (integer): Distinct tokens traded.
    - `realizedPnlUsd` (number | null): Realized PnL, USD.
    - `realizedComplete` (boolean): Whether the realized PnL covers every trade in the window.
- `mints` (integer): Distinct tokens the wallet ever traded.
- `truncated` (boolean): The datafeed stopped before reading the wallet's full history.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 401 |  |  | Wallet token missing, expired or rejected. The web client fetches a new token and retries once. | Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once. |

#### Example request

```bash
curl "https://datafeed.proxima.tools/wallet/9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM/summary?chain=solana"
```

#### Example response

```json
{
  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "chain": "solana",
  "windows": {
    "1d": {
      "volumeUsd": 40.3,
      "buyVolumeUsd": 18.4,
      "sellVolumeUsd": 21.9,
      "trades": 3,
      "buys": 2,
      "sells": 1,
      "tokens": 1,
      "realizedPnlUsd": 15,
      "realizedComplete": true
    }
  },
  "mints": 14,
  "truncated": false
}
```

### Retrieve wallet balances

`GET https://datafeed.proxima.tools/wallet/{addr}/balances`

Returns the tokens a Solana wallet holds on chain, priced where possible. (No auth · beta)

- Token: None. This endpoint is public.
- Retry: Safe to retry.

Solana only: the web client always sends `chain=solana` and polls every 15 seconds. A token with no price has `valueUsd: null`, never `0`.

#### Path parameters

- `addr` (string, required): Solana wallet address.

#### Query parameters

- `chain` (enum, required): Always `solana`. Possible values: `solana`.

#### Headers

- `Authorization` (string, required): `Bearer <wallet token>` from `GET /charts/wallet/token`.

#### Returns 200 OK

- `addr` (string): Echoed wallet.
- `chain` (enum): Always `solana`. Possible values: `solana`.
- `slot` (integer): Slot the balances were read at.
- `readAt` (integer): Read time, unix seconds.
- `live` (boolean): Whether the datafeed follows this wallet live.
- `fresh` (boolean): Whether the book is up to date.
- `native` (object): `{ lamports: string, balance, priceUsd, valueUsd }` for SOL.
- `items` (array<object>): One row per mint, every token account of that mint summed.
  - `mint` (string): Token mint.
  - `name` (string | null): Token name.
  - `symbol` (string | null): Ticker.
  - `image` (string | null): Image URL.
  - `program` (string): Token program.
  - `decimals` (integer): Mint decimals.
  - `amount` (string): Raw amount in base units.
  - `balance` (number): UI amount.
  - `accounts` (integer): Token accounts summed.
  - `priceUsd` (number | null): Price, USD.
  - `priceSource` (enum | null): Where the price came from. Possible values: `screener`, `swap`, `native`.
  - `priceAt` (integer | null): Price time.
  - `valueUsd` (number | null): Value, USD; `null` when unpriced.
- `totalValueUsd` (number): Sum of priced values, USD.
- `unpriced` (integer): Number of tokens without a price.
- `truncated` (boolean): The list was cut short (the web client labels it "largest 1,000").

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 401 |  |  | Wallet token missing, expired or rejected. The web client fetches a new token and retries once. | Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once. |

#### Example request

```bash
curl "https://datafeed.proxima.tools/wallet/9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM/balances?chain=solana"
```

#### Example response

```json
{
  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "chain": "solana",
  "slot": 377412908,
  "readAt": 1762001941,
  "live": true,
  "fresh": true,
  "native": {
    "lamports": "2500000000",
    "balance": 2.5,
    "priceUsd": 187.42,
    "valueUsd": 468.55
  },
  "items": [
    {
      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "name": "Moon Cat",
      "symbol": "MCAT",
      "image": null,
      "program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "decimals": 6,
      "amount": "1250000000000",
      "balance": 1250000,
      "accounts": 1,
      "priceUsd": 0.0000123,
      "priceSource": "screener",
      "priceAt": 1762001941,
      "valueUsd": 15.4
    }
  ],
  "totalValueUsd": 483.95,
  "unpriced": 0,
  "truncated": false
}
```

### List a wallet's daily activity

`GET https://datafeed.proxima.tools/wallet/{addr}/daily`

Returns one row per UTC day the wallet traded, newest first. (No auth · beta)

- Token: None. This endpoint is public.
- Retry: Safe to retry.

#### Path parameters

- `addr` (string, required): Wallet address.

#### Query parameters

- `chain` (string, optional): Datafeed chain slug.
- `days` (integer, optional): Span in days. The web client offers 7, 30 (default) and 90.

#### Headers

- `Authorization` (string, required): `Bearer <wallet token>` from `GET /charts/wallet/token`.

#### Returns 200 OK

- `addr` (string): Echoed wallet.
- `chain` (string | null): Echoed chain.
- `days` (integer): Echoed span.
- `available` (boolean): `false` where the charts database keeps no daily data yet.
- `items` (array<object>): Days, newest first.
  - `day` (string): UTC day.
  - `chains` (array<string>): Chains traded that day.
  - `trades` (integer): Trade count.
  - `buys` (integer): Buy count.
  - `sells` (integer): Sell count.
  - `tokens` (integer): Distinct tokens.
  - `volumeUsd` (number): Volume, USD.
  - `buyUsd` (number): Bought, USD.
  - `sellUsd` (number): Sold, USD.
  - `realizedPnlUsd` (number): Realized PnL, USD.
  - `realizedComplete` (boolean): Whether the PnL covers every trade of the day.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 401 |  |  | Wallet token missing, expired or rejected. The web client fetches a new token and retries once. | Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once. |

#### Example request

```bash
curl "https://datafeed.proxima.tools/wallet/9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM/daily?chain=solana&days=30"
```

#### Example response

```json
{
  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "chain": "solana",
  "days": 30,
  "available": true,
  "items": [
    {
      "day": "2026-11-01",
      "chains": [
        "solana"
      ],
      "trades": 3,
      "buys": 2,
      "sells": 1,
      "tokens": 1,
      "volumeUsd": 40.3,
      "buyUsd": 18.4,
      "sellUsd": 21.9,
      "realizedPnlUsd": 15,
      "realizedComplete": true
    }
  ]
}
```

### Retrieve a token image

`GET https://datafeed.proxima.tools/img/{chain}/{mint}`

Returns a coin's thumbnail, sized for list rows. (No auth · beta)

- Token: None. This endpoint is public.
- Retry: Safe to retry.

Loaded directly in an `<img>` tag, without credentials. With `ph=0` the datafeed answers an error when it has no image; without `ph` it answers a letter avatar. The screener's `useTokenImage` first requests `ph=0`, falls back to the letter avatar on error, and probes again after 10 and 30 seconds with `r=1` and `r=2` (`r` only changes the browser cache key).

#### Path parameters

- `chain` (string, required): Datafeed chain slug.
- `mint` (string, required): Token address.

#### Query parameters

- `s` (enum, required, default "64"): Size in pixels. Possible values: `64`, `128`.
- `ph` (enum, optional): `0` disables the letter-avatar placeholder. Possible values: `0`.
- `r` (integer, optional): Retry counter; cache-buster only.

#### Returns 200 OK

The image bytes.

#### Example request

```bash
curl "https://datafeed.proxima.tools/img/solana/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU?s=64"
```

#### Example response

```text
<binary>
```

### Send datafeed telemetry

`POST https://datafeed.proxima.tools/telemetry`

Uploads client-side latency samples for the datafeed socket. (No auth · internal)

- Token: None. This endpoint is public.
- Retry: Do not retry blindly. Each call records its samples again, so a retry can count them twice. The web app never retries.

Only a sample of sessions report: the decision is drawn once per tab with a probability of 5% by default and kept in `sessionStorage` under `pxa_telemetry`. Sampled tabs flush every 30 seconds and when the page becomes hidden, with `navigator.sendBeacon` (so the body goes out as `text/plain`), falling back to `fetch` with `keepalive`. At most 500 values per metric are kept between flushes.

The URL is always derived from the datafeed socket URL. Metrics sent: `ws_decode_ms` (protobuf decode time), `rpc_rtt_ms` (RPC round trip), `push_gap_ms` (time between two pushes), `push_latency_ms` (server emit to client receive, corrected by an estimated clock offset from `serverEmitMs`).

#### Body parameters

- `metrics` (array<object>, required): One entry per metric with samples.
  - `name` (enum, required): Metric name. Possible values: `ws_decode_ms`, `rpc_rtt_ms`, `push_gap_ms`, `push_latency_ms`.
  - `values` (array<number>, required): Non-negative samples in milliseconds.

#### Returns 200 OK

The web client ignores the response.

#### Example request

```bash
curl -X POST "https://datafeed.proxima.tools/telemetry" \
  -H "Content-Type: application/json" \
  -d '{
  "metrics": [
    {
      "name": "rpc_rtt_ms",
      "values": [
        41.2,
        38.7,
        55
      ]
    },
    {
      "name": "push_gap_ms",
      "values": [
        212,
        980,
        403
      ]
    }
  ]
}'
```

#### Example response

```json
null
```
