Token Unlock Schedule & Allocation Breakdown

{
  "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
}

{
  "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": "Observed identical to unlock_amount on every entry of both fixtures -- both fields appear to already be running totals, not per-event deltas; whether they ever diverge is unconfirmed from two fixtures."
          },
          "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, ascending by timestamp on both fixtures observed (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, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}