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}/subscribeon the main API returns{ ok, chain, mint, token }. Used for/symbol. - Unscoped tokens:
GET /charts/screener/tokenandGET /charts/wallet/tokenreturn{ token, expires_in }(300 seconds). Thescreenertoken opens/screenerand/screener/live; thewallettoken opens/wallet/{addr}/*. The web client caches each token until 60 seconds before itsexp.
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.
- GET
https://datafeed.proxima.tools/symbol - GET
https://datafeed.proxima.tools/screener - GET
https://datafeed.proxima.tools/wallet/{addr}/positions - GET
https://datafeed.proxima.tools/wallet/{addr}/trades - GET
https://datafeed.proxima.tools/wallet/{addr}/summary - GET
https://datafeed.proxima.tools/wallet/{addr}/balances - GET
https://datafeed.proxima.tools/wallet/{addr}/daily - GET
https://datafeed.proxima.tools/img/{chain}/{mint} - POST
https://datafeed.proxima.tools/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.
Attributes
-
chainstringDatafeed chain slug. -
mintstringToken mint or contract address. -
scorenumberRank score within the view; higher sorts first. Its scale depends on the view. -
namestring | nullToken name. -
symbolstring | nullToken ticker. -
imagestring | nullImage URL. -
launchpadstring | nullLaunchpad that created the coin. -
launchTsinteger | nullLaunch time, unix seconds. -
creatorstring | nullCreator address. -
venuestring | nullTrading venue. -
poolstring | nullPool address. -
quotestring | nullQuote asset. -
phasestring | nullLifecycle phase; the web client falls back tocurvewhen absent. -
curveProgressnumber | nullBonding-curve progress. -
priceUsdnumber | nullPrice in USD. -
mcapUsdnumber | nullMarket cap in USD. -
volumeUsdobject | nullUSD volume per window (Windows). -
buyVolumeUsdobject | nullUSD buy volume per window. -
sellVolumeUsdobject | nullUSD sell volume per window. -
tradesobject | nullTrade count per window. -
buysobject | nullBuy count per window. -
sellsobject | nullSell count per window. -
makersobject | nullDistinct traders per window. -
priceChangeobject | nullPrice move per window, in percent; any window may benull. -
makersCappedbooleanmakershit a counting cap. -
holdersinteger | nullHolder count. -
holdersCappedbooleanholdershit a counting cap. -
top10Pctnumber | nullShare of supply held by the top 10 holders, percent. -
snipersinteger | nullSniper count. -
bundlePctnumber | nullShare of supply the creation-block buyers (creator aside) still hold, percent. -
lastTradeAtinteger | nullTime of the last trade (unix seconds; unit inferred). -
terminalsobjectMap of trading terminal name to a count. -
updatedAtinteger | nullLast refresh time of the row (unix seconds; unit inferred). -
taxobject | null{ buyBps, sellBps, venue: { buy, sell } | null, transferFeeBps };buy/sellsplit fees intolp,protocol,creator,tax,total. -
factsobject | nullOn-chain token facts:name,symbol,uri,program,mintAuthorityRevoked,freezeAuthorityRevoked,transferFeeBps,transferHook,final,readAt. -
socialsobject{ website, twitter, telegram }, each nullable. -
devobject | nullCreator track record:launched,migrated,checked,since(date string),holdingPct,sold.
The WalletPosition object
A wallet's position in one token, as the wallet explorer lists it.
Attributes
-
chainstring | nullDatafeed chain slug. -
mintstringToken address. -
namestring | nullToken name. -
symbolstring | nullToken ticker. -
imagestring | nullImage URL. -
balancenumber | nullCurrent token balance. -
balanceSourceenumWhetherbalancewas read on chain or derived from trades.Possible valuesonchaintrades -
boughtTokennumberTokens bought. -
boughtUsdnumberUSD spent buying. -
buysintegerBuy count. -
soldTokennumberTokens sold. -
soldUsdnumberUSD received selling. -
sellsintegerSell count. -
avgBuyPriceUsdnumber | nullAverage buy price, USD. -
avgSellPriceUsdnumber | nullAverage sell price, USD. -
realizedPnlUsdnumber | nullRealized PnL, USD. -
remainingTokennumberTokens still held by trade accounting. -
unrealizedPnlUsdnumber | nullUnrealized PnL, USD. -
totalPnlUsdnumber | nullRealized plus unrealized PnL, USD. -
priceUsdnumber | nullCurrent price, USD. -
priceSourceenum | nullWherepriceUsdcame from.Possible valuesscreenerswap -
priceAtinteger | nullTime ofpriceUsd(unix seconds; unit inferred). -
valueUsdnumber | nullPosition value, USD. -
firstBuyAtinteger | nullTime of the first buy (unix seconds; unit inferred). -
lastActivityAtintegerTime of the last trade, unix seconds.
The WalletTrade object
One swap by a wallet.
Attributes
-
tsintegerTrade time, unix seconds. -
chainstring | nullDatafeed chain slug. -
mintstringToken address. -
symbolstring | nullToken ticker. -
imagestring | nullImage URL. -
sidestringbuyorsell. -
tokenAmountnumberToken amount. -
quoteAmountnumber | nullQuote amount. -
quoteSymbolstring | nullQuote ticker. -
quoteAddressstring | nullQuote token address. -
priceUsdnumber | nullToken price at the trade, USD. -
volumeUsdnumber | nullTrade size, USD. -
signaturestringTransaction signature or hash. -
innerIndexintegerIndex of the swap inside the transaction. -
platformstring | nullPlatform. -
venuestring | nullVenue. -
poolIdstring | nullPool address. -
terminalstringTrading terminal label, when detected. -
terminalConfidencestringConfidence of the terminal label. -
terminalStalebooleanTerminal label is stale.
Retrieve symbol stats
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
-
mintstring RequiredToken mint or contract address.Example7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
Headers
-
Authorizationstring RequiredBearer <chart token>for this mint, fromGET /charts/{launch_id}/subscribeon the main API.
Returns 200 OK · application/json
-
mintstringToken address. -
chainstringDatafeed chain slug. -
symbolstring | nullTicker. -
namestring | nullToken name. -
supplynumber | nullToken supply. -
totalTxCountinteger | nullTotal transaction count. -
windowsobjectKeysm5,h1,h4,h24; eachnullwhere the producer's row does not state it.Child attributes 5
-
{window}object | nullTrades over one window, keyedm5,h1,h4orh24.nullwhere the producer row does not state it.Child attributes 4
-
buysintegerBuy count. -
sellsintegerSell count. -
buyVolumeUsdnumberBuy volume, USD. -
sellVolumeUsdnumberSell volume, USD.
-
-
-
priceChangeobjectKeysm5,h1,h4,h24: price change in percent, ornull. -
updatedAtinteger | nullLast 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
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
-
chainsstring RequiredComma-separated datafeed chain slugs.Examplesolana,bsc -
viewstring Requirednew,trending,graduating,migrated,mcap, or a discover ranking<metric>_<window>with metricvolume,txns,mcapchange,mcapchangepctand windowm1,m5,m30,h1,h24.Examplevolume_h1 -
limitinteger OptionalPage size. The web client sends 100.Example100 -
cursorstring Optionalnextfrom the previous page.
Headers
-
Authorizationstring RequiredBearer <screener token>fromGET /charts/screener/token.
Returns 200 OK · application/json
-
viewstringEchoed view. -
chainsarray<string>Echoed chains. -
itemsarray<object>ScreenerItemrows, best first. -
nextstring | nullCursor for the next page,nullat the end.
Errors
| Status | Code | When 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
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
-
addrstring RequiredWallet address.Example9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
Query parameters
-
chainstring OptionalDatafeed chain slug.Examplesolana -
sortenum OptionalSort order. The web client sendsvalue.Possible valuesvalueactivity -
limitinteger OptionalPage size. The web client sends 50.Example50 -
cursorstring Optionalnextfrom the previous page.
Headers
-
Authorizationstring RequiredBearer <wallet token>fromGET /charts/wallet/token.
Returns 200 OK · application/json
-
addrstringEchoed wallet. -
chainstring | nullEchoed chain. -
openbooleanWhether only open positions are listed. -
sortenumApplied sort.Possible valuesvalueactivity -
itemsarray<object>WalletPositionrows. -
nextstring | nullCursor for the next page. -
truncatedbooleanThe datafeed stopped before reading the wallet's full history.
Errors
| Status | Code | When 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
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
-
addrstring RequiredWallet address.Example9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
Query parameters
-
chainstring OptionalDatafeed chain slug.Examplesolana -
mintstring OptionalRestrict to one token. -
limitinteger OptionalPage size. The web client sends 50.Example50 -
beforestring Optionalnextfrom the previous page.
Headers
-
Authorizationstring RequiredBearer <wallet token>fromGET /charts/wallet/token.
Returns 200 OK · application/json
-
addrstringEchoed wallet. -
chainstring | nullEchoed chain. -
mintstring | nullEchoed mint filter. -
itemsarray<object>WalletTraderows. -
nextstring | nullValue forbeforeon the next page. -
truncatedbooleanThe datafeed stopped before reading the wallet's full history.
Errors
| Status | Code | When 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
Retrieve a wallet summary
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
-
addrstring RequiredWallet address.Example9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
Query parameters
-
chainstring OptionalDatafeed chain slug.Examplesolana
Headers
-
Authorizationstring RequiredBearer <wallet token>fromGET /charts/wallet/token.
Returns 200 OK · application/json
-
addrstringEchoed wallet. -
chainstring | nullEchoed chain. -
windowsobjectKeys1d,7d,30d(each optional).Child attributes 10
-
{window}objectActivity over one window, keyed1d,7dor30d.Child attributes 9
-
volumeUsdnumberTotal volume, USD. -
buyVolumeUsdnumberBuy volume, USD. -
sellVolumeUsdnumberSell volume, USD. -
tradesintegerTrade count. -
buysintegerBuy count. -
sellsintegerSell count. -
tokensintegerDistinct tokens traded. -
realizedPnlUsdnumber | nullRealized PnL, USD. -
realizedCompletebooleanWhether the realized PnL covers every trade in the window.
-
-
-
mintsintegerDistinct tokens the wallet ever traded. -
truncatedbooleanThe datafeed stopped before reading the wallet's full history.
Errors
| Status | Code | When 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
Retrieve wallet balances
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
-
addrstring RequiredSolana wallet address.Example9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
Query parameters
-
chainenum RequiredAlwayssolana.Possible valuessolana
Headers
-
Authorizationstring RequiredBearer <wallet token>fromGET /charts/wallet/token.
Returns 200 OK · application/json
-
addrstringEchoed wallet. -
chainenumAlwayssolana.Possible valuessolana -
slotintegerSlot the balances were read at. -
readAtintegerRead time, unix seconds. -
livebooleanWhether the datafeed follows this wallet live. -
freshbooleanWhether the book is up to date. -
nativeobject{ lamports: string, balance, priceUsd, valueUsd }for SOL. -
itemsarray<object>One row per mint, every token account of that mint summed.Child attributes 13
-
mintstringToken mint. -
namestring | nullToken name. -
symbolstring | nullTicker. -
imagestring | nullImage URL. -
programstringToken program. -
decimalsintegerMint decimals. -
amountstringRaw amount in base units. -
balancenumberUI amount. -
accountsintegerToken accounts summed. -
priceUsdnumber | nullPrice, USD. -
priceSourceenum | nullWhere the price came from.Possible valuesscreenerswapnative -
priceAtinteger | nullPrice time. -
valueUsdnumber | nullValue, USD;nullwhen unpriced.
-
-
totalValueUsdnumberSum of priced values, USD. -
unpricedintegerNumber of tokens without a price. -
truncatedbooleanThe list was cut short (the web client labels it "largest 1,000").
Errors
| Status | Code | When 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
List a wallet's daily activity
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
-
addrstring RequiredWallet address.Example9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
Query parameters
-
chainstring OptionalDatafeed chain slug.Examplesolana -
daysinteger OptionalSpan in days. The web client offers 7, 30 (default) and 90.Example30
Headers
-
Authorizationstring RequiredBearer <wallet token>fromGET /charts/wallet/token.
Returns 200 OK · application/json
-
addrstringEchoed wallet. -
chainstring | nullEchoed chain. -
daysintegerEchoed span. -
availablebooleanfalsewhere the charts database keeps no daily data yet. -
itemsarray<object>Days, newest first.Child attributes 11
-
daystringUTC day. -
chainsarray<string>Chains traded that day. -
tradesintegerTrade count. -
buysintegerBuy count. -
sellsintegerSell count. -
tokensintegerDistinct tokens. -
volumeUsdnumberVolume, USD. -
buyUsdnumberBought, USD. -
sellUsdnumberSold, USD. -
realizedPnlUsdnumberRealized PnL, USD. -
realizedCompletebooleanWhether the PnL covers every trade of the day.
-
Errors
| Status | Code | When 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
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
-
chainstring RequiredDatafeed chain slug.Examplesolana -
mintstring RequiredToken address.Example7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
Query parameters
-
senum RequiredSize in pixels.Possible values64128 -
phenum Optional0disables the letter-avatar placeholder.Possible values0 -
rinteger OptionalRetry 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
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
-
metricsarray<object> RequiredOne entry per metric with samples.Child attributes 2
-
nameenum RequiredMetric name.Possible valuesws_decode_msrpc_rtt_mspush_gap_mspush_latency_ms -
valuesarray<number> RequiredNon-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