Tokenomist
  • Tokenomist
    • 👋Welcome to Tokenomist
    • ⭐Token Unlocks Page
    • 🔎Token Page
      • 📐Cliff, Linear, and Emission
      • 🔒TBD Locked
      • 🎯Precision & Assumption
  • Tokenomist Pro
    • 👑Tokenomist Pro
    • ↗️Token Emission
    • 📊Standard Allocation
    • 📦Release Mechanism
    • 🏆Pro Chart
      • 💲Price Analysis
      • 🫳Post Unlocks Analysis
    • 📅Unlock Events
    • 💸Fundraising Analytics
      • 📊Fundraising Screener
        • Key Metrics Explained
        • Understand Funding Stages
      • 📊Fundraising detail page
        • Fundraising insight bar chart
        • Funding Rounds, Valuation, Investors Table
      • 💡Use cases
    • 📁CSV Export
  • API Documents
    • 💻Introduction
    • API Endpoints
      • 📔Token List API
        • Token List API v1
        • Token List API v2
      • 📈Weekly Emission API
        • Weekly Emission API v1
        • Weekly Emission API v2
        • Weekly Emission API v3
      • 📈Allocations API
        • Allocations API v1
        • Allocations API v2
      • 📈Unlock Events API
        • Unlock Events API v1
        • Unlock Events API v2
        • Unlock Events API v3
      • 📈Daily Emission API
        • Daily Emission API v1
        • Daily Emission API v2
  • About us
    • 🔭Who we are
    • 📬Contact Us
    • 📢Press/ Media Kit
    • 👥Tokenomist Team Verification
  • Miscellaneous
    • 📖Tokenomist Methodologies
    • ❗Disclaimer
    • ⚠️Data Update Policy
    • 📜Token Listing Criteria
    • ❓FAQ
    • 🔗Official Links
Powered by GitBook
On this page
  1. API Documents
  2. API Endpoints
  3. 📈Weekly Emission API

Weekly Emission API v1

PreviousWeekly Emission APINextWeekly Emission API v2

Last updated 10 months ago

CtrlK
  • Getting Started
  • Endpoints: Emission API v1

Overview

A weekly aggregated emission per token. The start date is expected to be a Sunday and end date a Saturday. This will include both linear and cliff unlocks that happened in the specified week.

Included is the breakdown of beneficiaries into standard allocation, a Tokenomist™️ methodology for categorizing and grouping allocations from different projects into a comparable standard.

Getting Started

Base URL

https://api.unlocks.app

Authentication

Provide your api key in the x-api-key header.

GET https://api.unlocks.app/v1/emission
HEADER: x-api-key: <YOUR_API_KEY>

Endpoints: Emission API v1

Parameters

Note: tokenId needs to be specified.

  • tokenId (required): Get tokenId from Token List API

  • start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.

  • end (optional): The end date for time filtering in the format YYYY-MM-DD. Defaults to the current date.

Get Specific Date Range Example:

Replace the preferred start and end dates in indicated format.

curl -X 'GET' \
  'https://api.unlocks.app/v1/emission?tokenId=optimisim&start=YYYY-MM-DD&end=YYYY-MM-DD' \
  -H 'x-api-key: $YOUR_API_KEY'

Get Full Data Range Example:

Remove date completely to call the full range.

curl -X 'GET' \
  'https://api.unlocks.app/v1/emission?tokenId=optimisim' \
  -H 'x-api-key: $YOUR_API_KEY'

Response

{
    "metadata": {
        "queryDate": "2024-06-24T13:31:20Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2023-06-25T00:00:00Z",
            "endDate": "2023-07-02T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 31341653,
            "unlockValue": 40744148.9,
            "referencePrice": 1.3,
            "allocations": [
                "Core Contributors",
                "Investors"
            ],
            "standardAllocations": [
                "Founder / Team",
                "Private Investors"
            ]
        },
        {
            "startDate": "2023-07-02T00:00:00Z",
            "endDate": "2023-07-09T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 0,
            "unlockValue": 0,
            "referencePrice": 1.34,
            "allocations": [],
            "standardAllocations": []
        },
        {
            "startDate": "2023-07-09T00:00:00Z",
            "endDate": "2023-07-16T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 1683000,
            "unlockValue": 2036430,
            "referencePrice": 1.21,
            "allocations": [
                "Governance Fund"
            ],
            "standardAllocations": [
                "Community"
            ]
        },
        {
            "startDate": "2023-07-16T00:00:00Z",
            "endDate": "2023-07-23T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 0,
            "unlockValue": 0,
            "referencePrice": 1.45,
            "allocations": [],
            "standardAllocations": []
        },
        ...
    ]
}

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

Return Fields Explanation

Fields
Data Type
Description

startDate

timestamp

Start date of the aggregated emission

endDate

timestamp

End date of the aggregated emission

tokenName

string

Token name

tokenSymbol

string

Token symbol

unlockAmount

number

Total Unlock amount within specified period

unlockValue

number

Total Unlock value within specified period

referencePrice

number

Reference price for unlockValue calculation

allocations

object array

Allocation name

standardAllocations

object array

Standard allocation of this allocation