---
title: "Weekly Emission v3"
method: GET
path: "/v3/emission"
tags: ["Weekly Emission"]
---

# Weekly Emission v3

`GET /v3/emission`

## Request

- Base URL: `https://api.tokenomist.ai`
- URL: `https://api.tokenomist.ai/v3/emission`
- Auth: API key in header `x-api-key`

Weekly aggregated emission per token with AI assisted listings.

## Query parameters

- `tokenId` string, required
- `start` string, date
- `end` string, date

## Response `200`

Successful response

- object
  - `metadata` Metadata
    - `queryDate` string, date-time: Timestamp of the query
    - `credit` Credit: Optional quota state for the calling account, returned on most authenticated responses (both success and error). Treat it as optional: it may be absent on unauthenticated requests, demo/playground responses, and briefly right after a monthly reset. `used` is near-real-time and may lag the true count by a request or two.
      - `used` integer: Successful requests (status below 400) made by your account, across all its keys, since the start of the month; errors use no credit. May lag by a request or two.
      - `limit` integer: The plan's request quota for the window.
      - `resetAt` string, date-time: When the quota resets: the 1st of next month, 00:00 UTC (RFC 3339).
  - `status` boolean
  - `data` object[]
    - `startDate` string, date-time
    - `endDate` string, date-time
    - `tokenName` string
    - `tokenSymbol` string
    - `listedMethod` 'INTERNAL' | 'AI' | 'EXTERNAL'
    - `unlockAmount` number
    - `unlockValue` number
    - `referencePrice` number
    - `allocations` EmissionAllocation[]
      - `allocationName` string: Allocation name
      - `standardAllocationName` string: Standard allocation of this allocation
      - `unlockAmount` number: Total Unlock amount in date period
      - `unlockValue` number: Total unlock value in date period
    - `totalCumulativeUnlockedAmount` number

## Changes

- **2026-11-03** `de81c972d642`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tokenomist/apis/tokenomist-api/changes/v3/emission/get.md)

---

[API](https://skmtc.dev/tokenomist/apis/tokenomist-api.md) - [All operations](https://skmtc.dev/tokenomist/apis/tokenomist-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tokenomist/apis/tokenomist-api/revisions/37c15ea7bdbd?raw)