---
title: "Get newest tokens"
method: GET
path: "/v4/data/tokens/newest"
tags: ["Token API"]
---

# Get newest tokens

`GET /v4/data/tokens/newest`

/v4/data/tokens/newest

**400 credits per API call**

Returns the newest tokens minted on the blockchain based on mint timestamp, filtered by an activity window and optional category.

Supported blockchains:

*   Ethereum - ethereum-mainnet
*   Base - base-mainnet

\> 📘 Note for Free Users > > As a free user, your data is cached on a 1-day refresh cycle, and wallet queries run through tatumio.eth. This setup helps lower costs so you can easily try out the API. For real-time data, faster syncs, and the full capability of our platform, we recommend upgrading to a paid plan.

## Query parameters

- `chain` 'ethereum-mainnet' | 'base-mainnet', required — Chains supported by the tokens and wallets endpoints.
- `timeframe` '5m' | '15m' | '1h' | '3h' | '6h' | '1d' — Aggregation window used to compute the trend.
- `pagesize` number

## Response `200`

OK

- ResponseArrayTrendingToken — Array response wrapper for trending tokens.
  - `data` TrendingToken[], required
    - `rank` integer — Position in the trending list (1 = most trending).
    - `name` string — Token name.
    - `tokenAddress` string — Token contract address (lowercased for EVM chains).
    - `symbol` string — Token symbol or ticker.
    - `chain` 'ethereum-mainnet' | 'base-mainnet' — Chains supported by the tokens and wallets endpoints.
    - `type` string — Token type (e.g., fungible, nft, multitoken).
    - `fdv` number, double — Fully diluted valuation in USD.
    - `liquidity` number, double — Approximate on-chain liquidity in USD.
    - `priceUSD` number, double — Current price in USD.
    - `priceChanges` PriceChanges — Percentage price change (%) over each timeframe.
      - `5m` number — Change in the last 5 minutes.
      - `15m` number — Change in the last 15 minutes.
      - `1h` number — Change in the last hour.
      - `3h` number — Change in the last 3 hours.
      - `6h` number — Change in the last 6 hours.
      - `1d` number — Change in the last 24 hours.
    - `firstMint` string, date-time — ISO 8601 timestamp of the first mint seen for this token.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403` — Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500` — Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/revisions/8622ee4b8fae/schema)