What shipped
- 2026-11-19Token lookup lists risky pools for any token
GET /v1/tokens/{chainId}/{address}?includeRisky=true now answers for tokens held by 10,000 or more pools (native tokens, major stablecoins) on every sort. It was refused with a 400 before.
- 2026-11-19Pools search by token address or pool id is exact
On GET /v1/pools, a search term that is a full token address (0x + 40 hex) or pool id (0x + 64 hex) is now an exact match instead of a text scan, so it answers on large chains where it timed out. A symbol that only contains the term no longer matches.
- 2026-11-19Pool 24h volume, fees and fee APR are a rolling 24 hours
Pool volumeUsd24h, feesUsd24h and feeApr now cover the 24 complete hours ending at metricsAsOf, a new field on pool rows and details. Before, they covered the current UTC day so far, so they read low early in the day. Chart poolOverviewCurrent carries metricsAsOf too.
- 2026-11-19Positions batch endpoint
GET /v1/positions/batch returns up to 100 positions of one chain by id in one call (chainId, ids). Billed per position returned: ids listed in missing are not charged, and X-Units-Charged is the net charge. Counts as one request per 10 ids against the rate limit.
- 2026-11-19Token lookup endpoint
GET /v1/tokens/{chainId}/{address} returns a token's USD price with its source and pricedAt, trust flags (anchor, CoinGecko listing, GoPlus security, impersonation, DEX market) and a page of the pools holding it. Costs 2 units.
- 2026-11-19Requests refused for quota no longer use units
A request that costs more units than the monthly quota has left is refused with 429 and leaves those units untouched. Before, it used them up. X-Quota-Remaining on that 429 shows what is still spendable.
- 2026-11-19Polygon positions and pools indexed
Uniswap v4 positions and pools on Polygon (chainId 137, native POL) are served on every positions and pools route and listed in GET /v1/chains.
- 2026-11-19Pool 24h and 7-day volume and fees count by date
Pool volumeUsd24h, feesUsd24h, volumeTvl24h and feeApr now come only from the newest day, and volumeUsd7d and feesUsd7d from the 7 days ending there. A pool that last traded days ago shows 0 for its 24h figures instead of that older day's.
- 2026-11-19APR, fee APR and ROI sorts leave out positions under 24h
With includeRisky=false (the default), /v1/positions and /explore leave positions minted less than 24 hours ago out of the apr, fee_apr and roi sorts; each enters within an hour of turning 24 hours. owner, poolId and positionId reads are unchanged.
- 2026-11-19Low-activity label on pools: lowActivity field
Pool rows and details carry lowActivity: true, and position rows poolLowActivity: true, when the pool has at least $100K TVL, is at least 7 days old and traded under 1% of its TVL in 7 days. /explore shows a Low activity label; nothing is hidden or re-ranked.
- 2026-11-17Pools and positions responses send Cache-Control
Successful /v1/positions and /v1/pools responses send Cache-Control: private, max-age=15 and Vary: KC-APIKey, so your client may reuse one for 15 seconds; a reused copy costs no units. Errors and partial or stale answers send no-store.
- 2026-11-17/health reads the chain head from each chain's node
GET /health reads chainHeadBlock from the chain's RPC node, with DeFiLlama as the fallback, so chainHeadEstimated is false and /v1/stats indexedTo and byChain[].indexedUpToTimestamp are filled again during DeFiLlama outages.
- 2026-11-17Fee tiers below 0.01% show their exact rate
Pool and position fee labels show up to four decimals, so a 1-pip tier reads 0.0001% and a 50-pip tier 0.005% instead of 0.00%, and a fee such as 9.9993% is no longer rounded. The API's fee field is unchanged.
- 2026-11-04OpenAPI description and interactive API reference
GET /v1/openapi.json (free, no key) serves the OpenAPI 3.1 description of the positions, pools and metadata routes, also at tickwise.xyz/docs/openapi.json. /docs/api-reference is a Swagger reference; signed in, it sends live requests.
- 2026-11-04MCP server on npm as @tickwise/mcp
Run the MCP server on your machine over stdio with npx -y @tickwise/mcp and your API key in TICKWISE_API_KEY. It has the same tools as mcp.tickwise.xyz, and each call costs what its /v1 route costs.
- 2026-11-03Ink and Tempo positions and pools indexed
Uniswap v4 positions and pools on Ink (chainId 57073, native ETH) and Tempo (4217, gas is a dollar stablecoin, no native coin) are served on every positions and pools route and listed in GET /v1/chains.
- 2026-11-02MCP server for AI assistants
Added a read-only MCP server at mcp.tickwise.xyz with 10 tools over pools, positions, charts and transactions. Send your API key as Authorization: Bearer or X-API-Key; each call costs what its /v1 route costs. An agent skill is served at /skill.
- 2026-11-01Celo positions and pools indexed
Uniswap v4 positions and pools on Celo (chainId 42220, native CELO) are served on every positions and pools route and listed in GET /v1/chains. On /explore, Celo opens at Any value and Any TVL.
- 2026-10-31/explore drops default floors on HyperEVM, MegaETH and Zora
Selecting HyperEVM, MegaETH or Zora on /explore now opens Positions at Any value (no $1K pool-TVL floor) and Pools at Any TVL instead of $500+ / $10K+, so their small markets show. A floor you pick yourself is kept when you switch chains.
- 2026-10-31HyperEVM, MegaETH and Zora positions and pools indexed
Uniswap v4 positions and pools on HyperEVM (chainId 999, native HYPE), MegaETH (4326) and Zora (7777777) are served on every positions and pools route and listed in GET /v1/chains.
- 2026-10-30Log out now ends portal sessions on the server
Log out in the portal now calls POST /account/auth/logout, which revokes that session and every other portal session of the account at once, so a copied token stops working. API keys are not affected.
- 2026-10-29Robinhood Chain: look-alike stock tokens valued at $0
A token on Robinhood Chain that copies the "<Company> • Robinhood Token" name but is not an issued stock token is now valued at $0 and left out of ranked lists. Position 1546669 no longer shows $263M. assetClass=equity now includes 11 more issued stock tokens.
- 2026-10-23TVL in /v1/stats is checked against on-chain balances
/v1/stats tvlUsd and byChain[].tvlUsd now count each token at what the chain's PoolManager actually holds, so a pool zeroed for one unpriced token keeps its real USDC or ETH and indexer over-reports are removed.
- 2026-10-22Positions in unbacked pools no longer show inflated values
Open positions in pools flagged risky for lacking real backing now value the unbacked token at $0 and leave the default /v1/positions and /explore lists. On Arc this removes about $284M across six positions in USDC/USDB, USDB/ATC and USDC/ATC.
- 2026-10-22Pools no longer drop out when their price drifts
A pool trading more than 10% away from its token's market price now values that token at the lower of the two instead of reporting tvlUsd 0. Real pools such as Arbitrum ETH/LINK stay on /v1/pools and in /v1/stats.
- 2026-10-22Chain logos, and /explore links that open one chain
Chain names across the site show the chain's logo. /explore?chain=<chainId> opens the dashboard filtered to that chain, and in the All chains view a row's chain badge filters to its chain.
- 2026-10-22Pool TVL no longer counts pools without real backing
A pool whose stablecoin or native-token side holds under $1,000 against more than that of another token now reports tvlUsd 0 and is flagged risky on /v1/pools and /explore; on Arc, so are pools the indexer values at $0. Arc's /v1/stats tvlUsd falls by about $284M.
- 2026-10-22Token logos on Arc and for Robinhood native ETH
logoURI for Arc tokens and for native ETH on Robinhood Chain now points to an image that exists: Arc's majors use their Ethereum logos and other Arc tokens their DexScreener logo where one exists.
- 2026-10-22Arc (chain ID 5042) positions and pools indexed
Uniswap v4 positions and pools on Arc (chainId 5042, native USDC) are served on every positions and pools route and listed in GET /v1/chains. Native USDC and its 0x3600… ERC-20 interface are both valued as USDC.
- 2026-10-22Position gas cost shows the chain's native token
The gas costs row in a position's detail on /explore always said ETH. It now names the chain's native token: AVAX on Avalanche, USDC on Arc.
- 2026-10-19view=compact and fields= on position and pool routes
Position and pool list, detail and charts routes accept view=compact (a curated set, same units) and fields=a,b.c (dotted paths; an unknown path is 400). Default responses are unchanged. Compact charts send each series as a column on one t axis.
- 2026-10-19Transactions paging route and tick windows on charts
GET /v1/positions/{chainId}/{protocol}/{positionId}/transactions pages with limit and before (the transactionsNextCursor). Chart routes take ticksLimit (max 1,000), tickFrom and tickTo to window the liquidity bins.
- 2026-10-19asOf timestamps on pools and positions
Pools carry asOf.statsAt, when their price, tick, liquidity, TVL, volume and fees were last read. Positions carry asOf.priceAt, liquidityAt and feesAt. A value is null when unknown, never estimated.
- 2026-10-18Zero-value open positions are refreshed less often
An open position worth $0 before and after a refresh is not rewritten by it, so its amounts, metrics, token prices and pool statistics can be 18 to 30 hours old; lastSyncedAt and pricing.pricedAt still show the chain's latest refresh. A change in value is written at once.
- 2026-10-14Dynamic-fee pools report their fees
metrics.feesUsd24h, feesUsd7d, feesUsdTotal and feeApr are now served for dynamic-fee pools; they used to be 0 or absent. A day whose fees exceed its volume counts 0, and such a lifetime total is omitted, for every pool.
- 2026-10-14Uncollected fees come only from the chain
metrics.feesSource is now onchain, settled or unmeasured, never indexer. A reading older than the last liquidity change shows unmeasured (Pending on /explore). amounts.amount0 and amount1 use the pool's current price.
- 2026-10-14Pool charts include the daily tick
GET /v1/pools/{chainId}/{protocol}/{poolId}/charts returns tick on each poolPrice point: the canonical tick of that indexed daily observation, or null when unavailable or invalid. Existing price fields and position charts are unchanged.
- 2026-10-07Impersonator and phishing tokens excluded and labelled
/v1/positions, /v1/pools and /explore leave out tokens that reuse a major symbol (USDT, WETH) at another contract, carry a link or "visit" in the symbol, or that GoPlus reports as fakes. Affected rows carry a risk field (symbol-spoof, phishing-symbol, excluded-token, risky-pool).
- 2026-10-07Gas and APR figures on unchanged positions update less often
On an unchanged position, totalGasCostUsd (and pnlHodl, roi, apr through it) is re-valued every 4.5 to 7.5 hours, or 18 to 30 hours if worth $0; apr, aprExGas, feeApr and poolApr can lag up to 1% (relative). lastSyncedAt and pricing.pricedAt show the chain's latest refresh.
- 2026-10-06Locked and burned positions labelled on /explore
/explore marks a position owned by a burn address (0x…dEaD and similar) as "Locked LP" and one owned by the zero address as "Burned position". Both stay listed; the API response is unchanged.
- 2026-10-06Pools and positions show their Uniswap v4 hook
Pool and position rows and details on /v1/pools, /v1/positions and /explore carry hooks (the hook address, lower case) and customAccounting (true when it sets a returns-delta permission). A pool without a hook carries neither; a pool gains them on its next sync.
- 2026-10-04Breaking: sort=age is newest first; closed rate sorts use PnL
sort=age orders positions by creation time, newest first, for status=active, inactive and all; the Closed and All views used to return a different order. For status=inactive, sort=apr, fee_apr and roi are served as sort=pnl. Active-view order is unchanged.
- 2026-10-04Breaking: internal fields removed from position detail
GET /v1/positions/{chainId}/{protocol}/{positionId} no longer returns rawSubgraph, _id, __v, the tx* sync fields, rpcFees*, staleMisses, lastVerifiedAt, lastModifyBlock or the _id of nested objects. Every documented field is unchanged.
- 2026-10-04Uncollected fees read on-chain, with their source
Open positions' uncollected fees are re-read from the chain, sooner when a position changes, is new or its detail is opened. metrics.feesSource is onchain, indexer, settled (closed, nothing owed) or unmeasured (not read yet); metrics.feesMeasuredAt is when it was read.
- 2026-10-04List totals no longer hold up or fail a page
hasMore is always exact on /v1/positions and /v1/pools; pagination.total is exact or a proven minimum, flagged pagination.totalCapped: true when the count runs late or hits 25,000. Pool positionsCount and holdersCount can be null (countsPending: true on the list), not a 503.
- 2026-10-04All-chains lists answer when one chain is slow
When chainId is omitted and one chain does not answer in time, GET /v1/positions and GET /v1/pools return the other chains' rows with partial: true and missingChains naming those left out, instead of failing. A partial response is refunded.
- 2026-10-04Responses served from an older read are flagged
Lists are cached for 15 seconds. A list, count, pool detail or position detail served from an older read (a timed-out read, a lagging replica or a very deep page) carries stale: true and dataAsOf, the time the data was read.
- 2026-10-04Deep pages have no depth limit
Any page of GET /v1/positions and GET /v1/pools can be requested. A deep page that cannot be computed in one request answers 503 with Retry-After; progress is kept where possible, so retry after that interval. Every 5xx is refunded.
- 2026-10-04Position detail and charts no longer wait for long histories
If a long history is not ready, position detail returns the newest transactions with transactionsPartial: true and transactionsDegraded: true, and charts omit the position series with partial: true and missing: ["transactions"]. Both are refunded.
- 2026-10-04/v1/stats counts pools from the last complete pool sync
GET /v1/stats takes pools and tvlUsd, overall and per chain, from each chain's last complete pool sync, so they can be up to one sync old. Pools that sync could not price fall back to stored rows and still count.
- 2026-09-07Robinhood Chain (chain ID 4663) added
Uniswap v4 on Robinhood Chain (native ETH, USDG quote) is served on /v1/positions and /v1/pools, listed as robinhood in /v1/chains. Majors resolve from a fixed address list, other claimants to their symbols are flagged, and tokens without real two-sided reserves are priced at 0.
- 2026-09-07assetClass=equity filter for tokenized equities
GET /v1/positions and GET /v1/pools accept assetClass=equity, returning only rows with a tokenized-equity leg, such as NVDA, SPY or SPCX on Robinhood Chain. Omitting it returns everything as before. Equity legs report their ticker as symbol where the on-chain one was unreadable.
- 2026-09-07Position detail returns 200 when transactions cannot load
When the indexer cannot supply a position's transactions, GET /v1/positions/{chainId}/{protocol}/{positionId} returns 200 with transactions: [] and transactionsDegraded: true instead of 500. Treat the flag as unknown history, not empty. Such responses are refunded.
- 2026-08-31Chain and protocol pickers open on phones
The "All chains" and "Uniswap v4" pickers on /explore could not be opened on a touch screen. They now open on tap and close on a tap elsewhere.
- 2026-08-31Wallet search on /explore covers every page
Pasting a wallet address into /explore search filters every position it holds, via the owner filter of GET /v1/positions. Token and pool name search still covers only loaded rows, and the page now says which applied.
- 2026-08-31Shareable position links and refresh on /explore
Opening a position on /explore adds ?chain=&protocol=&position= to the URL, which reopens its detail on load; the share button gives out that link. The panel menu adds Refresh data and copy actions for the link, NFT ID and owner address.
- 2026-08-26Usage broken down by day, endpoint, key and response class
GET /account/usage/detail splits units and requests by day, endpoint, API key and response class (2xx, 4xx, 5xx, 429, refunded) over a from/to window of up to 92 days; groupBy returns one split. /portal/usage shows it, and GET /account/usage adds requests per month.
- 2026-08-26Rate-limit and quota headers readable from the browser
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-Quota-Limit, X-Quota-Remaining and X-Quota-Reset on /v1 responses are now exposed to browser JavaScript via CORS. A 429 also carries X-RateLimit-Reason (rate or quota), naming the limit hit.
- 2026-08-19Breaking: liquidity distribution prices are decimal-adjusted
liquidityDistribution.ticks[] on the position and pool charts routes gained liquidityNet and activeLiquidity; amount0/amount1 derive from active liquidity. price0 and price1 are decimal-adjusted, not raw 1.0001^tick (9.99e+11 is now 0.9999 on a 6/18-decimal pair): stop re-scaling them by token decimals.
- 2026-08-19Resend-verification reports whether the code was sent
POST /account/auth/resend-verification returns a delivered flag alongside ok. delivered: false means the code is valid but was not sent, a fault on our side that a retry does not fix; the field is absent when nothing needed sending.
- 2026-08-19Pricing page reads plan prices live
Plan prices, quotas and rate limits on /pricing are read from the plan catalogue per request instead of a one-hour cache; the unit allowances on the home page come from the same live catalogue.
- 2026-08-19Arbitrum One positions and pools indexed
Uniswap v4 positions and pools on Arbitrum One (chainId 42161) join Ethereum (1) and Avalanche C-Chain (43114), on every positions and pools route.
- 2026-08-19GET /v1/chains lists only chains with a live source
GET /v1/chains no longer returns registry chains with an empty protocols array; it lists only chains that have data behind them.
- 2026-08-15USDC paid to a voided invoice goes to your balance
A USDC transfer that lands on an invoice voided by a plan change, or after an abandoned checkout, is credited to your account balance and spent on the next invoice. Money moved to balance is no longer also counted as paying its invoice.
- 2026-08-15Cancel a pending plan change, and see confirmations
POST /account/billing/cancel-change calls off a started but unpaid plan change and returns the proration credit it consumed. While a payment confirms, the portal shows confirmations against the required minimum, with the transaction hash and an explorer link.
- 2026-08-14CopyPools is now Tickwise
The product was renamed and documentation examples now show the Tickwise host. No client change is needed: the KC-APIKey header and kc_live_ key prefix are unchanged, keys keep working and portal sessions survive the rename.
- 2026-08-14API playground in the portal
Pick an endpoint at /portal/playground, fill in the parameters, send the call with your own key and see the status, timing, response body and units spent. The key is never stored, logged or echoed back.
- 2026-08-14GET /v1/stats gained per-chain totals
GET /v1/stats added activePositions (open only), tvlUsd and a byChain array (chainId, protocol, pools, positions, activePositions, tvlUsd, indexedUpToTimestamp). tvlUsd counts only TVL that passed valuation checks, so treat it as a lower bound.
- 2026-08-14Public documentation, pricing and status pages
Docs cover quickstart, authentication, positions, pools and metadata references, units and limits, errors and a coverage matrix generated from the API's registry. Also live: a public pricing page and a status page showing how far each chain is indexed.
- 2026-08-13Self-serve plans, paid in USDC
Choose a plan in the portal and pay in USDC by signing an EIP-3009 transfer authorization; your entitlement follows the invoice. Renewals are raised ahead of the period end with a grace window and a downgrade to Free; nothing is charged automatically.
- 2026-08-06Self-serve signup and customer portal
Sign up for a Free plan and manage your own keys in the portal: create by type with allowed origins, revoke and delete. Sign in with a password, Google, GitHub or a wallet; email is verified by a six-digit code and password reset uses a single-use 30-minute token.
- 2026-08-06Unit costs tiered by route type
Metered routes no longer cost a flat 1 unit: metadata routes cost 0, detail 1, list 2 and chart 10. The meter and /pricing resolve through the same table; GET /v1/pricing/units returns it live.
- 2026-08-06Refused requests no longer consume quota
Units are credited back on every 4xx as well as every 5xx, so a rejected request (a 400 for a malformed protocol value, for example) no longer decrements X-Quota-Remaining. 429s were never charged.
- 2026-08-06Public /v1/plans, /v1/pricing/units and /v1/stats
Three unauthenticated, unmetered endpoints: plans with monthlyUnits, rateLimitPerMin, maxApiKeys, allowBrowserKeys and prices in integer minor units; the per-route unit cost table; and index counts with pools, positions and indexedTo.
- 2026-07-18owner filter on the positions endpoints
GET /v1/positions accepts owner=0x… (case-insensitive) to fetch every indexed position held by one wallet. It composes with the other filters, so pass status=all&minValueUsd=0&minPoolTvl=0&includeRisky=true for a wallet's complete set.
- 2026-07-03Avalanche C-Chain positions and pools indexed
Uniswap v4 on Avalanche C-Chain (chainId 43114, native AVAX) is served on every positions and pools route alongside Ethereum.
- 2026-07-03Breaking: omitting chainId now returns every chain
chainId became optional on /v1/positions and /v1/pools. A request that omits it previously defaulted to Ethereum; it now returns a merged, re-sorted result across every enabled chain with summed pagination totals. If you relied on the old default, pass chainId=1 explicitly.
- 2026-06-24GET /health reports indexed block vs chain head
The free GET /health route returns indexedBlock, chainHeadBlock, lagBlocks, synced and status per integration. The older indexedUpToTimestamp field is retained.
- 2026-06-17Breaking: keyless /api/* routes closed to third parties
In production, the /api/top-* dashboard routes refuse with 403 any request whose Origin is missing or not on our allowlist. Server-side and scripted callers must use /v1 with a KC-APIKey header.
- 2026-06-16Server and browser API keys, with origin binding
Every key now has a type. A server key is refused with 403 on any request carrying an Origin header; a browser key must be issued with at least one allowed origin and works only from those origins.
- 2026-06-16Metered pool and chart endpoints
Added GET /v1/pools, GET /v1/pools/{chainId}/{protocol}/{poolId} and the pool and position charts routes, each metered under its own route key. range accepts 30d, 60d, 90d, 180d or all (default 30d). Pool responses carry positionsCount and holdersCount (open positions only).
- 2026-06-12Valuations gated on real market activity
Token legs that are neither anchors nor allowlisted are valued only with real 24h volume and counter-side liquidity on an independent DEX; fabricated and dead-pool positions read $0 or leave default lists. Added priceConfidence, nominalValueUsd, unrealizableLeg, priceUnavailable.
- 2026-06-01Metered /v1 API with keys, plans and quota headers
/v1/positions list and detail launched behind a KC-APIKey header; /v1/chains and /v1/protocols are free. Four plans, Free to Enterprise, set monthly unit quotas and per-minute rate limits, sent as X-RateLimit-* and X-Quota-* headers; exceeding either returns 429 with Retry-After.
- 2026-05-13Uniswap v4 positions on Ethereum
The first release: ranked Uniswap v4 positions on Ethereum, sortable by APR, fee APR, ROI, age, PnL or underlying value, filterable by status, range, minimum value and pool TVL, with a detail view of per-position amounts, fees, PnL and transaction history.