Token Unlock Schedule & Allocation Breakdown

omnial/token-tokenomics

Given a token symbol or project id, returns a time series of scheduled token unlock events -- the amount unlocked at each point, the running cumulative total unlocked, total token supply, the percentage of total supply unlocked so far, and a breakdown of each unlock by allocation bucket (e.g. investors, team, treasury, ecosystem funds).

activeper callv2

Price

Up to $0.0164 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/token-tokenomics" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/token-tokenomics" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/token-tokenomics", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/token-tokenomics", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0164

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "id"
      ]
    },
    {
      "required": [
        "symbol"
      ]
    }
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Project id, when already known from a previous response. Takes priority over symbol when both are given. Example: 25c6612a-395c-4974-94eb-3b5f9f4b2ed7."
    },
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "End of the date range to return unlock events for. Accepts Unix seconds (1735689600) or a date string (2025-01-01). Example: 2025-01-01."
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Start of the date range to return unlock events for. Accepts Unix seconds (1704067200) or a date string (2024-01-01). Example: 2024-01-01."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Token symbol, e.g. ARB, OP, APT. Example: ARB."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "integer",
            "description": "Unix seconds of the unlock event."
          },
          "allocations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Allocation bucket label, e.g. 'Investors', 'Team, Future Team + Advisors', 'Seed Fund', 'User Airdrops' -- a category name, never a person or company identity."
                },
                "amount": {
                  "type": "number",
                  "description": "Tokens unlocked in this bucket."
                }
              },
              "additionalProperties": false
            },
            "description": "Breakdown of this unlock point by allocation bucket. Bucket names and counts vary by token (5 buckets observed for one token, 8 for another) -- do not assume a fixed set of buckets or a fixed count across tokens."
          },
          "total_supply": {
            "type": "number",
            "description": "Total token supply, the denominator for the unlocked percentage."
          },
          "unlock_amount": {
            "type": "number",
            "description": "Tokens unlocked as of this point in the schedule (a running total)."
          },
          "cumulative_unlocked_amount": {
            "type": "number",
            "description": "Typically identical to unlock_amount on every entry -- both fields appear to already be running totals, not per-event deltas; whether they ever diverge is unconfirmed."
          },
          "unlocked_percentage_of_total_supply": {
            "type": "number",
            "description": "cumulative_unlocked_amount as a percentage of total_supply, 0-100."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per unlock event on the token's schedule, typically ascending by timestamp (e.g. 31 entries for a no-date-range symbol lookup, 4 entries for a one-month range)."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer",
          "description": "Echoes the effective limit for this call."
        },
        "total": {
          "type": "integer",
          "description": "Total unlock events available for the query."
        },
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from the provider's cache."
        },
        "offset": {
          "type": "integer",
          "description": "Echoes the effective offset for this call."
        }
      },
      "additionalProperties": false
    }
  },
  "description": "The unlock-schedule response.",
  "additionalProperties": false
}