Skip to content
API Reference

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

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

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.

Attributes

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

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

Attributes

  • 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 onchaintrades
  • 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 screenerswap
  • 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.

One swap by a wallet.

Attributes

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

Retrieve symbol stats

No auth beta
GET https://datafeed.proxima.tools/symbol

Served outside the main API host.

Returns a coin's header figures: supply, transaction count, per-window buys and sells, and price changes.

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

Headers

  • Authorization string Required
    Bearer <chart token> for this mint, from GET /charts/{launch_id}/subscribe on the main API.

Returns 200 OK · application/json

  • 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.
    Child attributes 5
    • {window} object | null
      Trades over one window, keyed m5, h1, h4 or h24. null where the producer row does not state it.
      Child attributes 4
      • 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).

Errors

Only the common errors: 429 when rate limited.

Web client getSymbolStats(chartToken, mint) src/lib/datafeedHttp/client.ts

List a screener view

No auth beta
GET https://datafeed.proxima.tools/screener

Served outside the main API host.

Returns one page of a screener ranking across one or more chains.

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). 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.
    Examplesolana,bsc
  • 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.
    Examplevolume_h1
  • limit integer Optional
    Page size. The web client sends 100.
    Example100
  • cursor string Optional
    next from the previous page.

Headers

  • Authorization string Required
    Bearer <screener token> from GET /charts/screener/token.

Returns 200 OK · application/json

  • 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

StatusCodeWhen and 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 and retry once.

Also the common errors: 429 when rate limited.

Web client getScreener(screenerToken, { chains, view, limit, cursor }) src/lib/datafeedHttp/client.ts

List wallet positions

No auth beta
GET https://datafeed.proxima.tools/wallet/{addr}/positions

Served outside the main API host.

Returns a wallet's token positions with cost basis and PnL.

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

Query parameters

  • chain string Optional
    Datafeed chain slug.
    Examplesolana
  • sort enum Optional
    Sort order. The web client sends value.
    Possible values valueactivity
  • limit integer Optional
    Page size. The web client sends 50.
    Example50
  • cursor string Optional
    next from the previous page.

Headers

  • Authorization string Required
    Bearer <wallet token> from GET /charts/wallet/token.

Returns 200 OK · application/json

  • addr string
    Echoed wallet.
  • chain string | null
    Echoed chain.
  • open boolean
    Whether only open positions are listed.
  • sort enum
    Applied sort.
    Possible values valueactivity
  • 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

StatusCodeWhen and 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 and retry once.

Also the common errors: 429 when rate limited.

Web client getWalletPositions(walletToken, addr, { chain, sort, limit, cursor }) src/lib/datafeedHttp/client.ts

List wallet trades

No auth beta
GET https://datafeed.proxima.tools/wallet/{addr}/trades

Served outside the main API host.

Returns a wallet's swaps, newest first, optionally for one token.

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

Path parameters

  • addr string Required
    Wallet address.
    Example9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

Query parameters

  • chain string Optional
    Datafeed chain slug.
    Examplesolana
  • mint string Optional
    Restrict to one token.
  • limit integer Optional
    Page size. The web client sends 50.
    Example50
  • before string Optional
    next from the previous page.

Headers

  • Authorization string Required
    Bearer <wallet token> from GET /charts/wallet/token.

Returns 200 OK · application/json

  • 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

StatusCodeWhen and 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 and retry once.

Also the common errors: 429 when rate limited.

Web client getWalletTrades(walletToken, addr, { chain, mint, limit, before }) src/lib/datafeedHttp/client.ts

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

Served outside the main API host.

Returns a wallet's trading totals over 1, 7 and 30 days.

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

Path parameters

  • addr string Required
    Wallet address.
    Example9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

Query parameters

  • chain string Optional
    Datafeed chain slug.
    Examplesolana

Headers

  • Authorization string Required
    Bearer <wallet token> from GET /charts/wallet/token.

Returns 200 OK · application/json

  • addr string
    Echoed wallet.
  • chain string | null
    Echoed chain.
  • windows object
    Keys 1d, 7d, 30d (each optional).
    Child attributes 10
    • {window} object
      Activity over one window, keyed 1d, 7d or 30d.
      Child attributes 9
      • 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

StatusCodeWhen and 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 and retry once.

Also the common errors: 429 when rate limited.

Web client getWalletSummary(walletToken, addr, { chain }) src/lib/datafeedHttp/client.ts

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

Served outside the main API host.

Returns the tokens a Solana wallet holds on chain, priced where possible.

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

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 · application/json

  • 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.
    Child attributes 13
    • 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 screenerswapnative
    • 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

StatusCodeWhen and 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 and retry once.

Also the common errors: 429 when rate limited.

Web client getWalletBalances(walletToken, addr) src/lib/datafeedHttp/client.ts

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

Served outside the main API host.

Returns one row per UTC day the wallet traded, newest first.

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

Path parameters

  • addr string Required
    Wallet address.
    Example9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

Query parameters

  • chain string Optional
    Datafeed chain slug.
    Examplesolana
  • days integer Optional
    Span in days. The web client offers 7, 30 (default) and 90.
    Example30

Headers

  • Authorization string Required
    Bearer <wallet token> from GET /charts/wallet/token.

Returns 200 OK · application/json

  • 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.
    Child attributes 11
    • 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

StatusCodeWhen and 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 and retry once.

Also the common errors: 429 when rate limited.

Web client getWalletDaily(walletToken, addr, { chain, days }) src/lib/datafeedHttp/client.ts

Retrieve a token image

No auth beta
GET https://datafeed.proxima.tools/img/{chain}/{mint}

Served outside the main API host.

Returns a coin's thumbnail, sized for list rows.

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.
    Examplesolana
  • mint string Required
    Token address.
    Example7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU

Query parameters

  • s enum Required Default 64
    Size in pixels.
    Possible values 64128
  • ph enum Optional
    0 disables the letter-avatar placeholder.
    Possible values 0
  • r integer Optional
    Retry counter; cache-buster only.

Returns 200 OK · image/*

The image bytes.

Errors

Only the common errors: 429 when rate limited.

Web client tokenImageUrl(chain, mint, size) src/lib/datafeedHttp/client.ts

Send datafeed telemetry

No auth internal
POST https://datafeed.proxima.tools/telemetry

Served outside the main API host.

Uploads client-side latency samples for the datafeed socket.

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 application/json

  • metrics array<object> Required
    One entry per metric with samples.
    Child attributes 2
    • name enum Required
      Metric name.
      Possible values ws_decode_msrpc_rtt_mspush_gap_mspush_latency_ms
    • values array<number> Required
      Non-negative samples in milliseconds.

Returns 200 OK · application/json

The web client ignores the response.

Errors

Only the common errors: 429 when rate limited.

Web client telemetry.record(name, value) (flushed automatically) src/lib/datafeed/telemetry.ts