> ## Documentation Index
> Fetch the complete documentation index at: https://coinstats.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Product updates and announcements

<Update label="June 24th, 2026" tags={["Added"]}>
  **All-time high/low added to coin response**

  * Coin responses now include `allTimeHigh` and `allTimeLow`, returned in the requested `currency`.
  * Fields are optional and only present for coins that have the data.
</Update>

<Update label="May 18th, 2026" tags={["Changed"]}>
  **Free plan limits updated**

  * Free plan credits reduced from 50,000 to **20,000** credits/month.
  * Free plan rate limit reduced from 5 req/sec to **2 req/sec**.
</Update>

<Update label="May 16th, 2026" tags={["Added"]}>
  **Token Risks endpoint**

  * New: **GET /token-risks** — 5000 credits. Smart-contract risk analysis powered by Hexens: overall risk score plus detailed findings (centralized mint/burn, blacklist/whitelist, pausable/blockable transfers, hidden fees, upgradeable proxy, ownership not renounced, balance manipulation, and more).
  * Accepts either `coinId` (CoinStats coin id) or an explicit `contractAddress` + `chain` pair. Optional `sortBy=severity`.
  * Returns an empty `results` list when no risk data is available (non-EVM tokens or contracts not yet indexed).
</Update>

<Update label="May 14th, 2026" tags={["Added"]}>
  **ConnectKit launched**

  * Added [ConnectKit](/connectkit), a hosted CoinStats popup flow for connecting wallets and exchanges from partner apps.
  * Added ConnectKit setup in the [API dashboard](https://openapi.coinstats.app/connect-kits) with trusted origins, redirect URLs, branding, mode, appearance, and accent color controls.
  * Added browser integrations through `@coinstats/connectkit` and the hosted `https://connect.coinstats.app/coinstats-connect.js` script.
  * Frontend apps use only the public ConnectKit ID and callback URL. API keys stay server-side.
</Update>

<Update label="May 14th, 2026" tags={["Added"]}>
  **Flare EVM chain support**

  * Added support for the MegaETH EVM chain across wallet endpoints.
</Update>

<Update label="May 11th, 2026" tags={["Changed"]}>
  **Wallet multi-balance endpoint renamed**

  * New: **GET /wallet/balance/many** — same credits and response shape as the previous `/wallet/balances`.
  * **GET /wallet/balances** is deprecated and removed from the API reference. It continues to work and now returns `Deprecation: true` and a `Link` header pointing to `/wallet/balance/many`. Migrate when convenient.
</Update>

<Update label="May 7th, 2026" tags={["Added"]}>
  **Sei EVM chain support**

  * Added support for the Sei EVM chain across wallet endpoints.
  * Includes balances.
</Update>

<Update label="April 30th, 2026" tags={["Added"]}>
  **MegaETH EVM chain support**

  * Added support for the MegaETH EVM chain across wallet endpoints.
  * Includes balances, DeFi positions, and transaction history.
</Update>

<Update label="April 28th, 2026" tags={["Improved"]}>
  **PnL endpoints added for connected wallets and exchanges**

  * **GET /wallet/pl** — 25 credits
  * **GET /exchange/pl** — 25 credits
  * Returns holdings with PnL fields, `totalCost`, and summary totals.

  **Wallet Transactions — credit cost reduced from 40 to 30 per request**

  * **GET /wallet/transactions** — 30 credits (was 40)
  * API reference, wallet guides, multiplier docs, and x402 pricing now reflect the updated cost.
</Update>

<Update label="March 17th, 2026" tags={["Improved"]}>
  **Market Insights — credit cost reduced from 50 to 10 per request**

  * **GET /insights/btc-dominance** — 10 credits (was 50)
  * **GET /insights/fear-and-greed** — 10 credits (was 50)
  * **GET /insights/fear-and-greed/chart** — 10 credits (was 50)
  * **GET /insights/rainbow-chart/\{coinId}** — 10 credits (was 50)
</Update>

<Update label="March 10th, 2026" tags={["Added"]}>
  **GET /portfolio/list** — 5 credits

  * New endpoint to retrieve all API-connected portfolios.
  * Returns `portfolioId` and `portfolioName` for each portfolio created via `POST /portfolio/wallet` or `POST /portfolio/exchange`.
</Update>

<Update label="March 5th, 2026" tags={["Changed"]}>
  **Plan Updates**

  * Introduced the new **Starter** plan: 1,000,000 credits/month, 30 req/sec, \$49/month.
  * Free plan credits reduced from 1,000,000 to **50,000** credits/month.
  * Renamed **Individual** plan to **Pro**.
  * Renamed **Custom** plan to **Enterprise**.
</Update>

<Update label="February 26th, 2026" tags={["Added", "Improved"]}>
  **POST /portfolio/wallet** — Connect a wallet to your CoinStats account

  * Connect any supported blockchain wallet address to your account.
  * Returns a `portfolioId` you can use on all `/portfolio` GET endpoints.

  **POST /portfolio/exchange** — Connect an exchange and create a tracked portfolio

  * Connect an exchange to your CoinStats account
  * Returns a `portfolioId` you can use on all `/portfolio` GET endpoints.

  **GET /portfolio/\*** — `portfolioId` now accepted

  * All portfolio GET endpoints (`/value`, `/coins`, `/chart`, `/transactions`, `/defi`, `/snapshot/items`) now accept a `portfolioId` query parameter.
  * `portfolioId` is returned from `POST /portfolio/wallet` or `POST /portfolio/exchange`.
  * `shareToken` remains fully supported and is unchanged.
  * If neither is provided, endpoints return aggregated data for all API-connected portfolios.
</Update>

<Update label="January 22th, 2026" tags={["Improved"]}>
  **GET /portfolio/transactions** - Now supports `note` in response
</Update>

<Update label="January 15th, 2026" tags={["Added"]}>
  **GET /usage/credits** — 0 credits

  * New endpoint to check your remaining credit limit programmatically.
  * Returns total credits, used credits, remaining credits, and subscription plan.
  * This endpoint is free and does not consume any credits.
</Update>

<Update label="December 9th, 2025" tags={["Improved"]}>
  * **GET /wallet/balance** - Now accepts either `connectionId` or `blockchain` parameter
  * **GET /wallet/balances** - Added `blockchain` parameter (comma-separated list)
  * **GET /wallet/chart** - Now accepts either `connectionId` or `blockchain` parameter
  * **GET /wallet/defi** - Now accepts either `connectionId` or `blockchain` parameter
  * **GET /wallet/transactions** - Now accepts either `connectionId` or `blockchain` parameter
  * **PATCH /wallet/transactions** - Now accepts either `connectionId` or `blockchain` parameter
  * If both `connectionId` and `blockchain` are provided, `connectionId` takes precedence
</Update>

<Update label="November 19th, 2025" tags={["Improved"]}>
  **GET /wallet/transactions**

  * Added `coinId` query param to filter transactions by coin.
</Update>

<Update label="November 10th, 2025" tags={["Improved"]}>
  **GET /wallet/transactions**

  * Now supports `toAddress` adn `fromAddress` optional properties in the response
</Update>

<Update label="October 2nd, 2025" tags={["Improved", "Added"]}>
  **GET /coins**

  * Now supports retrieving Ordinals by specifying the `bitcoin` blockchain in the query.

  **GET /wallet/defi**

  * You can now specify multiple `connectionIds` in the query to fetch DeFi data for several connections at once.
</Update>

<Update label="September 1st, 2025" tags={["Improved"]}>
  * Enhanced all existing endpoints for better performance and reliability.
  * Added comprehensive examples and detailed descriptions to all endpoints.
  * Introduced the [Share Token explanation page](/sharetoken) for better understanding.
  * Launched the [Credit Multipliers page](/multipliers) to explain credit usage.
</Update>

<Update label="August 22nd, 2025" tags={["Improved"]}>
  **GET /wallet/balances**

  * Added `wallets` query parameter to support multiple wallet addresses in a single request
  * Added `connectionId` field to response when using the `wallets` query parameter

  **GET /coins**

  * Added `coinIds` query parameter to filter coins by specific IDs
</Update>

<Update label="June 11th, 2025" tags={["Improved"]}>
  **GET /coins**

  * Added a new `contractAddresses` field in coin data.
  * Lists smart contract addresses for tokens (e.g., ERC-20).
  * Empty for native coins like Bitcoin.

  **GET /coins/{coinId}**

  * Added a new `contractAddresses` field in coin data.
  * Lists smart contract addresses for tokens (e.g., ERC-20).
  * Empty for native coins like Bitcoin.
</Update>

<Update label="June 6th, 2025" tags={["Added"]}>
  **GET /portfolio/value** — 10 credits
</Update>

<Update label="June 4th, 2025" tags={["Added"]}>
  **GET /portfolio/defi** — 200 credits
</Update>

<Update label="May 20th, 2025" tags={["Improved"]}>
  **GET /wallet/transactions**

  * Added a new `wallets` query parameter.
  * This update allows users to retrieve transaction history for multiple wallets in a single API call.
</Update>

<Update label="May 19th, 2025" tags={["Added"]}>
  **GET /insights/btc-dominance** — 50 credits
  **GET /insights/fear-and-greed** — 50 credits
  **GET /insights/fear-and-greed/chart** — 50 credits
  **GET /insights/rainbow-chart/{coinId}** — 50 credits
</Update>

<Update label="May 8th, 2025" tags={["Added","Improved"]}>
  **GET /wallet/charts**

  * Allows users to retrieve chart data for multiple chains and wallets in a single request.

  **PATCH /wallet/transactions**

  * Now supports syncing multiple chains and wallets with a single API call.
</Update>