{ "openapi": "3.0.0", "info": { "description": "OpenAPI specification for the entire Messari API", "title": "Messari API - Token Unlocks V1", "version": "1.0.0" }, "servers": [ { "description": "Messari API", "url": "https://api.messari.io" } ], "security": [], "paths": { "/token-unlocks/v1/allocations": { "get": { "description": "Returns allocation information given a set of asset IDs and optional filters", "operationId": "getAllocationsByAssetIDs", "parameters": [ { "description": "Asset identifier - accepts either slug (e.g. 'solana') or UUID", "in": "query", "name": "assetId", "required": true, "schema": { "type": "string", "example": "solana", "default": "solana" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/AllocationAggregate" }, "type": "array" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "asset": { "id": "97775be0-2608-4720-b7af-f85b24c7eb2d", "name": "XRP", "slug": "xrp", "symbol": "XRP" }, "genesisDate": "2012-06-01T00:00:00Z", "projectedEndDate": "2022-06-01T00:00:00Z", "totalAllocationUSD": 238697977801.6666, "totalAllocationNative": 100000000000, "cumulativeUnlockedUSD": 238697977801.6666, "cumulativeUnlockedNative": 100000000000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "allocationRecipientCount": 3, "lastUpdatedAt": "2025-03-08T13:19:53.477266Z", "allocations": [ { "allocationRecipient": "Founders", "totalAllocationUSD": 47739595560.33332, "totalAllocationNative": 20000000000, "cumulativeUnlockedUSD": 47739595560.33332, "cumulativeUnlockedNative": 20000000000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "20% allocated to founders. Chris Larsen and Jed McCaleb recieved 9.5 billion XRP each and Aurthur Britto recieved 1 billion XRP.", "assumptions": "", "sources": [ { "sourceType": "Third-party Website", "source": "https://tokeninsight.com/en/coins/ripple/tokenomics" } ] }, { "allocationRecipient": "Ripple", "totalAllocationUSD": 190480986285.72995, "totalAllocationNative": 79800000000, "cumulativeUnlockedUSD": 190480986285.72995, "cumulativeUnlockedNative": 79800000000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "79.8% allocated to Ripple. In December 2017 55 billion XRP were escrowed, with 1 billion XRP released per month.", "assumptions": "Monthly unlocks on the first. Ripple is a private company and not a foundation.", "sources": [ { "sourceType": "Third-party Website", "source": "https://tokeninsight.com/en/coins/ripple/tokenomics" } ] }, { "allocationRecipient": "Airdrop", "totalAllocationUSD": 477395955.6033332, "totalAllocationNative": 200000000, "cumulativeUnlockedUSD": 477395955.6033332, "cumulativeUnlockedNative": 200000000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "0.2% allocated to airdrop.", "assumptions": "", "sources": [ { "sourceType": "Third-party Website", "source": "https://tokeninsight.com/en/coins/ripple/tokenomics" } ] } ] }, { "asset": { "id": "e5150c9a-f6a8-4bb1-80db-0c21bc452d71", "name": "SuperWalk", "slug": "superwalk", "symbol": "grnd" }, "genesisDate": "2022-09-06T00:00:00Z", "projectedEndDate": "2028-02-05T00:00:00Z", "totalAllocationUSD": 37892295.48666718, "totalAllocationNative": 1000000000, "cumulativeUnlockedUSD": 28648240.808871932, "cumulativeUnlockedNative": 756043951.44, "unlocksRemainingUSD": 9244054.677795246, "unlocksRemainingNative": 243956048.56, "percentOfUnlocksCompleted": 0.75604395144, "allocationRecipientCount": 9, "lastUpdatedAt": "2025-06-29T20:50:20.888134Z", "allocations": [ { "allocationRecipient": "Move to Earn", "totalAllocationUSD": 17430455.9238669, "totalAllocationNative": 460000000, "cumulativeUnlockedUSD": 9459792.891891861, "cumulativeUnlockedNative": 249649507.12, "unlocksRemainingUSD": 7970663.03197504, "unlocksRemainingNative": 210350492.88, "percentOfUnlocksCompleted": 0.5427163198260869, "description": "46% allocation, 0% of allocation released at TGE, followed by 5-month cliff then 60-month linear vesting.", "assumptions": "", "sources": [ { "sourceType": "Project Documents", "source": "https://docs.superwalk.io/english/tokenomics/usdgrnd-governance-token" } ] }, { "allocationRecipient": "IDO", "totalAllocationUSD": 88415.34350479158, "totalAllocationNative": 2333333, "cumulativeUnlockedUSD": 88415.34350479158, "cumulativeUnlockedNative": 2333333, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "0.2333% allocation, 100% of allocation released at TGE, no cliff or vesting.", "assumptions": "", "sources": [ { "sourceType": "Project Documents", "source": "https://docs.superwalk.io/english/tokenomics/usdgrnd-governance-token" } ] }, { "allocationRecipient": "Team", "totalAllocationUSD": 5683844.323000077, "totalAllocationNative": 150000000, "cumulativeUnlockedUSD": 5683844.323000077, "cumulativeUnlockedNative": 150000000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "15% allocation, 0% of allocation released at TGE, followed by 12-month cliff then 24-month linear vesting.", "assumptions": "", "sources": [ { "sourceType": "Project Documents", "source": "https://docs.superwalk.io/english/tokenomics/usdgrnd-governance-token" } ] }, { "allocationRecipient": "Ecosystem", "totalAllocationUSD": 3321891.2502952544, "totalAllocationNative": 87666667, "cumulativeUnlockedUSD": 2048499.604475048, "cumulativeUnlockedNative": 54061111.32, "unlocksRemainingUSD": 1273391.6458202065, "unlocksRemainingNative": 33605555.68, "percentOfUnlocksCompleted": 0.6166666667046895, "description": "8.7667% allocation, 0% of allocation released at TGE, no cliff, followed by 60-month linear vesting.", "assumptions": "", "sources": [ { "sourceType": "Project Documents", "source": "https://docs.superwalk.io/english/tokenomics/usdgrnd-governance-token" } ] }, { "allocationRecipient": "Liquidity", "totalAllocationUSD": 454707.54584000615, "totalAllocationNative": 12000000, "cumulativeUnlockedUSD": 454707.54584000615, "cumulativeUnlockedNative": 12000000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "1.2% allocation, 80% of allocation released at TGE, followed by 3-month cliff for the remaining 20%, no vesting.", "assumptions": "", "sources": [ { "sourceType": "Project Documents", "source": "https://docs.superwalk.io/english/tokenomics/usdgrnd-governance-token" } ] } ] }, { "asset": { "id": "37d2bdc2-ff12-4342-871b-7a12a240e954", "name": "PoolTogether", "slug": "pooltogether", "symbol": "POOL" }, "genesisDate": "2021-02-17T00:00:00Z", "projectedEndDate": "2028-08-08T00:00:00Z", "totalAllocationUSD": 14038964.688588783, "totalAllocationNative": 9996000, "cumulativeUnlockedUSD": 11021694.485205283, "cumulativeUnlockedNative": 7847648.35, "unlocksRemainingUSD": 3017270.203383498, "unlocksRemainingNative": 2148351.65, "percentOfUnlocksCompleted": 0.7850788665466186, "allocationRecipientCount": 7, "lastUpdatedAt": "2024-12-26T02:48:30.068492Z", "allocations": [ { "allocationRecipient": "Retroactive Depositers", "totalAllocationUSD": 1966241.5530236391, "totalAllocationNative": 1400000, "cumulativeUnlockedUSD": 1966241.5530236391, "cumulativeUnlockedNative": 1400000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "100% vested at TGE.", "assumptions": "", "sources": [ { "sourceType": "Project Website", "source": "https://medium.com/pooltogether/introducing-pool-23b09f36db48" } ] }, { "allocationRecipient": "Treasury", "totalAllocationUSD": 8075634.949918518, "totalAllocationNative": 5750000, "cumulativeUnlockedUSD": 5058364.74653502, "cumulativeUnlockedNative": 3601648.35, "unlocksRemainingUSD": 3017270.203383498, "unlocksRemainingNative": 2148351.65, "percentOfUnlocksCompleted": 0.6263736260869566, "description": "Non-linear vesting dependent on governance", "assumptions": "Took 1407 days for 51%, assume it will take similar time to unlock rest.", "sources": [ { "sourceType": "Project Website", "source": "https://medium.com/pooltogether/introducing-pool-23b09f36db48" } ] }, { "allocationRecipient": "Team / Contributors", "totalAllocationUSD": 1747146.0656867193, "totalAllocationNative": 1244000, "cumulativeUnlockedUSD": 1747146.0656867193, "cumulativeUnlockedNative": 1244000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "1 year cliff, followed by linear monthly vesting over 1 year.", "assumptions": "", "sources": [ { "sourceType": "Project Website", "source": "https://medium.com/pooltogether/introducing-pool-23b09f36db48" } ] }, { "allocationRecipient": "Liquidity Mining", "totalAllocationUSD": 702229.1260798711, "totalAllocationNative": 500000, "cumulativeUnlockedUSD": 702229.1260798711, "cumulativeUnlockedNative": 500000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "14 week liquidity mining program where 5,100 POOL is distributed per day.", "assumptions": "", "sources": [ { "sourceType": "Project Website", "source": "https://medium.com/pooltogether/introducing-pool-23b09f36db48" } ] }, { "allocationRecipient": "Voters", "totalAllocationUSD": 140445.8252159742, "totalAllocationNative": 100000, "cumulativeUnlockedUSD": 140445.8252159742, "cumulativeUnlockedNative": 100000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "100% vested at TGE.", "assumptions": "", "sources": [ { "sourceType": "Project Website", "source": "https://medium.com/pooltogether/introducing-pool-23b09f36db48" } ] } ] }, { "asset": { "id": "1e31218a-e44e-4285-820c-8282ee222035", "name": "Bitcoin", "slug": "bitcoin", "symbol": "BTC" }, "genesisDate": "2009-01-03T00:00:00Z", "projectedEndDate": "2139-12-31T00:00:00Z", "totalAllocationUSD": 2299094996083.345, "totalAllocationNative": 21000000, "cumulativeUnlockedUSD": 2182973547532.4656, "cumulativeUnlockedNative": 19939343.34, "unlocksRemainingUSD": 116121448550.87973, "unlocksRemainingNative": 1060656.6600000001, "percentOfUnlocksCompleted": 0.9494925399999999, "allocationRecipientCount": 1, "lastUpdatedAt": "2025-03-18T13:52:25.458369Z", "allocations": [ { "allocationRecipient": "Block Rewards", "totalAllocationUSD": 2299094996083.345, "totalAllocationNative": 21000000, "cumulativeUnlockedUSD": 2182973547532.4656, "cumulativeUnlockedNative": 19939343.34, "unlocksRemainingUSD": 116121448550.87973, "unlocksRemainingNative": 1060656.6600000001, "percentOfUnlocksCompleted": 0.9494925399999999, "description": "Incetive given to miners for successfully adding new block to the bitcoin network. Distribution mechanisim of 21 million BTC. ", "assumptions": "Estimation of daily block rewards and halvening dates. ", "sources": [ { "sourceType": "Whitepaper", "source": "https://bitcoin.org/bitcoin.pdf" } ] } ] }, { "asset": { "id": "9fb6e340-7969-4047-86ae-d60cb11a70ad", "name": "FLOKI", "slug": "floki", "symbol": "FLOKI" }, "genesisDate": "2021-06-21T00:00:00Z", "projectedEndDate": "2021-06-21T00:00:00Z", "totalAllocationUSD": 733123.7104386332, "totalAllocationNative": 10000000000, "cumulativeUnlockedUSD": 733123.7104386332, "cumulativeUnlockedNative": 10000000000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "allocationRecipientCount": 1, "lastUpdatedAt": "2024-09-15T04:35:20.130704Z", "allocations": [ { "allocationRecipient": "Community", "totalAllocationUSD": 733123.7104386332, "totalAllocationNative": 10000000000, "cumulativeUnlockedUSD": 733123.7104386332, "cumulativeUnlockedNative": 10000000000, "unlocksRemainingUSD": 0, "unlocksRemainingNative": 0, "percentOfUnlocksCompleted": 1, "description": "100% vested at TGE.", "assumptions": "", "sources": [ { "sourceType": "Project Website", "source": "https://floki.com/timeline" } ] } ] } ] } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "403": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Forbidden" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get Allocations information by asset IDs", "tags": [ "token-unlocks/Allocations" ] } }, "/token-unlocks/v1/assets": { "get": { "description": "Returns assets with allocation information given a set of filters", "operationId": "getFilteredAssets", "parameters": [ { "description": "Page number for pagination", "in": "query", "name": "page", "schema": { "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "type": "integer", "example": 10, "default": 10 } }, { "description": "Comma-separated list of asset IDs (UUIDs) to filter by", "in": "query", "name": "assetIDs", "schema": { "type": "string", "example": "7e532302-9ced-4e90-8c8a-218a38e1dbba,1c077d6e-99c7-491c-b24d-1d359011cd81", "default": "7e532302-9ced-4e90-8c8a-218a38e1dbba,1c077d6e-99c7-491c-b24d-1d359011cd81" } }, { "description": "Comma-separated list of categories to filter by", "in": "query", "name": "category", "schema": { "type": "string", "example": "Networks,DeFi", "default": "Networks,DeFi" } }, { "description": "Comma-separated list of sectors to filter by", "in": "query", "name": "sector", "schema": { "type": "string", "example": "Smart Contract Platform", "default": "Smart Contract Platform" } }, { "description": "Comma-separated list of tags to filter by", "in": "query", "name": "tags", "schema": { "type": "string", "example": "Proof-of-Stake,EVM", "default": "Proof-of-Stake,EVM" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/token-unlocksAsset" }, "type": "array" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "id": "1c077d6e-99c7-491c-b24d-1d359011cd81", "serialId": 609, "symbol": "TRX", "name": "TRON", "genesisDate": "2017-09-13T00:00:00Z", "projectedEndDate": "2017-09-13T00:00:00Z", "slug": "tron", "category": "Networks", "sector": "Smart Contract Platform", "tags": [ "EVM", "Proof-of-Stake", "SEC Alleged Securities", "Stakeable" ], "otherInfo": null }, { "id": "7c435a77-5be9-4424-b5d1-1c02b968c56f", "serialId": 378, "symbol": "XLM", "name": "Stellar", "genesisDate": "2015-11-24T00:00:00Z", "projectedEndDate": "2023-04-05T00:00:00Z", "slug": "stellar", "category": "Financial Services", "sector": "Payments", "tags": null, "otherInfo": null }, { "id": "99b6a5f4-2200-4098-82fd-53d091bdee70", "serialId": 756013, "symbol": "HYPE", "name": "Hyperliquid", "genesisDate": "2024-11-29T00:00:00Z", "projectedEndDate": "2027-10-28T00:00:00Z", "slug": "hyperliquid", "category": "Marketplaces", "sector": "Exchange", "tags": [ "Decentralized Exchange", "DeFi", "Perpetuals" ], "otherInfo": null }, { "id": "78c4b0c5-8cbe-4f05-b639-0eb942e86dd5", "serialId": 21023, "symbol": "SUI", "name": "Sui", "genesisDate": "2023-05-01T00:00:00Z", "projectedEndDate": "2030-05-01T00:00:00Z", "slug": "sui", "category": "Networks", "sector": "Smart Contract Platform", "tags": null, "otherInfo": "Sui unlock data is only supported up to 2030 (47.83% of the total allocation), as the project only released data for the next 7 years; therefore, the unlock data for Mysten Labs Treasury, Early Contributors, Community Reserve is incomplete in the vesting schedule. Furthermore, tokens allocated to inflationary categories (Stake Subsidies) are not accounted for in the unlock data below. " }, { "id": "2db6b38a-681a-4514-9d67-691e319597ee", "serialId": 1265, "symbol": "AVAX", "name": "Avalanche", "genesisDate": "2020-09-21T00:00:00Z", "projectedEndDate": "2030-07-20T00:00:00Z", "slug": "avalanche", "category": "Networks", "sector": "Layer-0", "tags": [ "Proof-of-Stake", "Stakeable" ], "otherInfo": null } ] } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "403": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Forbidden" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get Filtered Assets with Allocation information", "tags": [ "token-unlocks/Assets" ] } }, "/token-unlocks/v1/assets/{assetId}/events": { "get": { "description": "Returns unlock events for a given asset", "operationId": "getEvents", "parameters": [ { "description": "Asset identifier - accepts either slug (e.g. 'solana') or UUID", "in": "path", "name": "assetId", "required": true, "schema": { "type": "string", "example": "ethereum", "default": "ethereum" } }, { "description": "RFC3339 formatted start time", "in": "query", "name": "startTime", "schema": { "format": "date-time", "type": "string", "example": "2020-01-01T00:00:00Z", "default": "2020-01-01T00:00:00Z" } }, { "description": "RFC3339 formatted end time", "in": "query", "name": "endTime", "schema": { "format": "date-time", "type": "string", "example": "2025-12-31T00:00:00Z", "default": "2025-12-31T00:00:00Z" } }, { "description": "Type of unlock event", "in": "query", "name": "unlockType", "schema": { "enum": [ "CLIFF", "LINEAR" ], "type": "string", "example": "LINEAR", "default": "LINEAR" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/Events" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "asset": { "id": "b3d5d66c-26a2-404c-9325-91dc714a722b", "name": "Solana", "slug": "solana", "symbol": "SOL" }, "unlockEvents": [ { "timestamp": "2020-04-07T00:00:00Z", "cliff": { "amountNative": 8225000, "amountUSD": 1553853121.763593, "percentOfTotalAllocation": 0.017267440639892512, "allocations": [ { "allocationRecipient": "Coinlist Auction Sale", "amountNative": 8200000, "amountUSD": 1549130163.9466825, "percentOfTotalAllocation": 0.017214956017886758 }, { "allocationRecipient": "Solana Foundation", "amountNative": 25000, "amountUSD": 4722957.816910617, "percentOfTotalAllocation": 5.248462200575231e-05 } ] }, "dailyLinearRateChange": null }, { "timestamp": "2020-05-07T00:00:00Z", "cliff": { "amountNative": 8187500, "amountUSD": 1546768685.038227, "percentOfTotalAllocation": 0.017188713706883883, "allocations": [ { "allocationRecipient": "Community Reserve", "amountNative": 8187500, "amountUSD": 1546768685.038227, "percentOfTotalAllocation": 0.017188713706883883 } ] }, "dailyLinearRateChange": null }, { "timestamp": "2020-06-07T00:00:00Z", "cliff": { "amountNative": 8187500, "amountUSD": 1546768685.038227, "percentOfTotalAllocation": 0.017188713706883883, "allocations": [ { "allocationRecipient": "Community Reserve", "amountNative": 8187500, "amountUSD": 1546768685.038227, "percentOfTotalAllocation": 0.017188713706883883 } ] }, "dailyLinearRateChange": null }, { "timestamp": "2020-07-07T00:00:00Z", "cliff": { "amountNative": 8187500, "amountUSD": 1546768685.038227, "percentOfTotalAllocation": 0.017188713706883883, "allocations": [ { "allocationRecipient": "Community Reserve", "amountNative": 8187500, "amountUSD": 1546768685.038227, "percentOfTotalAllocation": 0.017188713706883883 } ] }, "dailyLinearRateChange": null }, { "timestamp": "2020-08-07T00:00:00Z", "cliff": { "amountNative": 8187500, "amountUSD": 1546768685.038227, "percentOfTotalAllocation": 0.017188713706883883, "allocations": [ { "allocationRecipient": "Community Reserve", "amountNative": 8187500, "amountUSD": 1546768685.038227, "percentOfTotalAllocation": 0.017188713706883883 } ] }, "dailyLinearRateChange": null } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "403": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Forbidden" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get Events by Asset ID", "tags": [ "token-unlocks/Assets" ] } }, "/token-unlocks/v1/assets/{assetId}/unlocks": { "get": { "description": "Returns interval-based unlock timeseries data for a given asset and interval", "operationId": "getUnlocksTimeseries", "parameters": [ { "description": "Asset identifier - accepts either slug (e.g. 'solana') or UUID", "in": "path", "name": "assetId", "required": true, "schema": { "type": "string", "example": "solana", "default": "solana" } }, { "description": "RFC3339 formatted start time", "in": "query", "name": "startTime", "schema": { "format": "date-time", "type": "string", "example": "2025-01-20T00:00:00Z", "default": "2025-01-20T00:00:00Z" } }, { "description": "RFC3339 formatted end time", "in": "query", "name": "endTime", "schema": { "format": "date-time", "type": "string", "example": "2025-02-01T00:00:00Z", "default": "2025-02-01T00:00:00Z" } }, { "description": "Aggregation interval for unlock data", "in": "query", "name": "interval", "required": true, "schema": { "enum": [ "DAILY", "WEEKLY", "MONTHLY", "QUARTERLY", "YEARLY" ], "type": "string", "example": "WEEKLY", "default": "WEEKLY" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/Unlock" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "asset": { "id": "b3d5d66c-26a2-404c-9325-91dc714a722b", "name": "Solana", "slug": "solana", "symbol": "SOL" }, "genesisDate": "2020-04-07T00:00:00Z", "projectedEndDate": "2029-03-01T00:00:00Z", "startDate": "2020-04-07T00:00:00Z", "endDate": "2021-04-07T00:00:00Z", "interval": "MONTHLY", "totalSnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "unlockedInPeriodUSD": 1553853121.763593, "unlockedInPeriodNative": 8225000 }, { "timestamp": "2020-05-07T00:00:00Z", "unlockedInPeriodUSD": 1546768685.038227, "unlockedInPeriodNative": 8187500 }, { "timestamp": "2020-06-07T00:00:00Z", "unlockedInPeriodUSD": 1546768685.038227, "unlockedInPeriodNative": 8187500 }, { "timestamp": "2020-07-07T00:00:00Z", "unlockedInPeriodUSD": 1546768685.038227, "unlockedInPeriodNative": 8187500 }, { "timestamp": "2020-08-07T00:00:00Z", "unlockedInPeriodUSD": 1546768685.038227, "unlockedInPeriodNative": 8187500 } ], "allocations": [ { "allocationRecipient": "Team", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-05-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-06-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-07-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-08-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 } ] }, { "allocationRecipient": "Strategic Sale", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-05-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-06-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-07-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-08-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 } ] }, { "allocationRecipient": "Coinlist Auction Sale", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "unlockedInPeriodUSD": 1549130163.9466825, "unlockedInPeriodNative": 8200000 }, { "timestamp": "2020-05-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-06-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-07-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-08-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 } ] }, { "allocationRecipient": "Community Reserve", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-05-07T00:00:00Z", "unlockedInPeriodUSD": 1546768685.038227, "unlockedInPeriodNative": 8187500 }, { "timestamp": "2020-06-07T00:00:00Z", "unlockedInPeriodUSD": 1546768685.038227, "unlockedInPeriodNative": 8187500 }, { "timestamp": "2020-07-07T00:00:00Z", "unlockedInPeriodUSD": 1546768685.038227, "unlockedInPeriodNative": 8187500 }, { "timestamp": "2020-08-07T00:00:00Z", "unlockedInPeriodUSD": 1546768685.038227, "unlockedInPeriodNative": 8187500 } ] }, { "allocationRecipient": "Seed Round Investors", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-05-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-06-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-07-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 }, { "timestamp": "2020-08-07T00:00:00Z", "unlockedInPeriodUSD": 0, "unlockedInPeriodNative": 0 } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "403": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Forbidden" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get Unlock Timeseries Data per Interval", "tags": [ "token-unlocks/Assets" ] } }, "/token-unlocks/v1/assets/{assetId}/vesting-schedule": { "get": { "description": "Returns vesting schedule timeseries data for a given asset", "operationId": "getVestingScheduleTimeseries", "parameters": [ { "description": "Asset identifier - accepts either slug (e.g. 'solana') or UUID", "in": "path", "name": "assetId", "required": true, "schema": { "type": "string", "example": "solana", "default": "solana" } }, { "description": "RFC3339 formatted start time", "in": "query", "name": "startTime", "schema": { "format": "date-time", "type": "string", "example": "2025-01-20T00:00:00Z", "default": "2025-01-20T00:00:00Z" } }, { "description": "RFC3339 formatted end time", "in": "query", "name": "endTime", "schema": { "format": "date-time", "type": "string", "example": "2025-02-01T00:00:00Z", "default": "2025-02-01T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/VestingSchedule" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "asset": { "id": "b3d5d66c-26a2-404c-9325-91dc714a722b", "name": "Solana", "slug": "solana", "symbol": "SOL" }, "genesisDate": "2020-04-07T00:00:00Z", "projectedEndDate": "2029-03-01T00:00:00Z", "startTime": "2020-04-07T00:00:00Z", "endTime": "2021-03-07T00:00:00Z", "totalDailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "cumulativeUnlockedUSD": 1553853121.763593, "cumulativeUnlockedNative": 8225000, "unlocksRemainingUSD": 88433606755.39777, "unlocksRemainingNative": 468105000, "percentOfUnlocksCompleted": 0.017267440639892512 }, { "timestamp": "2020-04-08T00:00:00Z", "cumulativeUnlockedUSD": 1553853121.763593, "cumulativeUnlockedNative": 8225000, "unlocksRemainingUSD": 88433606755.39777, "unlocksRemainingNative": 468105000, "percentOfUnlocksCompleted": 0.017267440639892512 }, { "timestamp": "2020-04-09T00:00:00Z", "cumulativeUnlockedUSD": 1553853121.763593, "cumulativeUnlockedNative": 8225000, "unlocksRemainingUSD": 88433606755.39777, "unlocksRemainingNative": 468105000, "percentOfUnlocksCompleted": 0.017267440639892512 }, { "timestamp": "2020-04-10T00:00:00Z", "cumulativeUnlockedUSD": 1553853121.763593, "cumulativeUnlockedNative": 8225000, "unlocksRemainingUSD": 88433606755.39777, "unlocksRemainingNative": 468105000, "percentOfUnlocksCompleted": 0.017267440639892512 }, { "timestamp": "2020-04-11T00:00:00Z", "cumulativeUnlockedUSD": 1553853121.763593, "cumulativeUnlockedNative": 8225000, "unlocksRemainingUSD": 88433606755.39777, "unlocksRemainingNative": 468105000, "percentOfUnlocksCompleted": 0.017267440639892512 } ], "allocations": [ { "allocationRecipient": "Validator Sale", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 4892984298.319399, "unlocksRemainingNative": 25900000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-08T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 4892984298.319399, "unlocksRemainingNative": 25900000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-09T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 4892984298.319399, "unlocksRemainingNative": 25900000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-10T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 4892984298.319399, "unlocksRemainingNative": 25900000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-11T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 4892984298.319399, "unlocksRemainingNative": 25900000, "percentOfUnlocksCompleted": 0 } ] }, { "allocationRecipient": "FTX Estate", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 2234903638.962104, "unlocksRemainingNative": 11830000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-08T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 2234903638.962104, "unlocksRemainingNative": 11830000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-09T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 2234903638.962104, "unlocksRemainingNative": 11830000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-10T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 2234903638.962104, "unlocksRemainingNative": 11830000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-11T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 2234903638.962104, "unlocksRemainingNative": 11830000, "percentOfUnlocksCompleted": 0 } ] }, { "allocationRecipient": "Founding Sale", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 8850822948.890495, "unlocksRemainingNative": 46850000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-08T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 8850822948.890495, "unlocksRemainingNative": 46850000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-09T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 8850822948.890495, "unlocksRemainingNative": 46850000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-10T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 8850822948.890495, "unlocksRemainingNative": 46850000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-11T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 8850822948.890495, "unlocksRemainingNative": 46850000, "percentOfUnlocksCompleted": 0 } ] }, { "allocationRecipient": "Team", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 12090772011.29118, "unlocksRemainingNative": 64000000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-08T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 12090772011.29118, "unlocksRemainingNative": 64000000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-09T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 12090772011.29118, "unlocksRemainingNative": 64000000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-10T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 12090772011.29118, "unlocksRemainingNative": 64000000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-11T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 12090772011.29118, "unlocksRemainingNative": 64000000, "percentOfUnlocksCompleted": 0 } ] }, { "allocationRecipient": "Strategic Sale", "dailySnapshots": [ { "timestamp": "2020-04-07T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 1775832139.158392, "unlocksRemainingNative": 9400000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-08T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 1775832139.158392, "unlocksRemainingNative": 9400000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-09T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 1775832139.158392, "unlocksRemainingNative": 9400000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-10T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 1775832139.158392, "unlocksRemainingNative": 9400000, "percentOfUnlocksCompleted": 0 }, { "timestamp": "2020-04-11T00:00:00Z", "cumulativeUnlockedUSD": 0, "cumulativeUnlockedNative": 0, "unlocksRemainingUSD": 1775832139.158392, "unlocksRemainingNative": 9400000, "percentOfUnlocksCompleted": 0 } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "403": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Forbidden" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get Vesting Schedule Timeseries Data", "tags": [ "token-unlocks/Assets" ] } } }, "components": { "schemas": { "Unlock": { "properties": { "allocations": { "items": { "$ref": "#/components/schemas/AllocationUnlockTranche" }, "type": "array" }, "asset": { "$ref": "#/components/schemas/AssetBasic" }, "endDate": { "format": "date-time", "type": "string" }, "genesisDate": { "format": "date-time", "type": "string" }, "interval": { "enum": [ "DAILY", "WEEKLY", "MONTHLY", "QUARTERLY", "YEARLY" ], "type": "string" }, "projectedEndDate": { "format": "date-time", "type": "string" }, "startDate": { "format": "date-time", "type": "string" }, "totalSnapshots": { "items": { "$ref": "#/components/schemas/UnlockSnapshot" }, "type": "array" } }, "required": [ "allocations", "asset", "endDate", "interval", "startDate", "totalSnapshots" ], "type": "object" }, "token-unlocksAsset": { "properties": { "category": { "type": "string" }, "genesisDate": { "format": "date-time", "type": "string" }, "id": { "format": "byte", "type": "string" }, "name": { "type": "string" }, "otherInfo": { "type": "string" }, "projectedEndDate": { "format": "date-time", "type": "string" }, "sector": { "type": "string" }, "serialId": { "format": "int32", "type": "integer" }, "slug": { "type": "string" }, "symbol": { "type": "string" }, "tags": { "items": { "type": "string" }, "type": "array" } }, "required": [ "category", "id", "name", "sector", "serialId", "slug", "symbol", "tags" ], "type": "object" }, "AllocationAggregate": { "properties": { "allocationRecipientCount": { "format": "int64", "type": "integer" }, "allocations": { "items": { "$ref": "#/components/schemas/AllocationTranche" }, "type": "array" }, "asset": { "$ref": "#/components/schemas/AssetBasic" }, "cumulativeUnlockedNative": { "format": "double", "type": "number" }, "cumulativeUnlockedUSD": { "format": "double", "type": "number" }, "genesisDate": { "format": "date-time", "type": "string" }, "lastUpdatedAt": { "format": "date-time", "type": "string" }, "percentOfUnlocksCompleted": { "format": "double", "type": "number" }, "projectedEndDate": { "format": "date-time", "type": "string" }, "totalAllocationNative": { "format": "double", "type": "number" }, "totalAllocationUSD": { "format": "double", "type": "number" }, "unlocksRemainingNative": { "format": "double", "type": "number" }, "unlocksRemainingUSD": { "format": "double", "type": "number" } }, "required": [ "allocationRecipientCount", "allocations", "asset", "cumulativeUnlockedNative", "percentOfUnlocksCompleted", "totalAllocationNative", "unlocksRemainingNative" ], "type": "object" }, "Events": { "properties": { "asset": { "$ref": "#/components/schemas/AssetBasic" }, "unlockEvents": { "items": { "$ref": "#/components/schemas/UnlockEvent" }, "type": "array" } }, "required": [ "asset", "unlockEvents" ], "type": "object" }, "VestingSchedule": { "properties": { "allocations": { "items": { "$ref": "#/components/schemas/AllocationVestingScheduleTranche" }, "type": "array" }, "asset": { "$ref": "#/components/schemas/AssetBasic" }, "endTime": { "format": "date-time", "type": "string" }, "genesisDate": { "format": "date-time", "type": "string" }, "projectedEndDate": { "format": "date-time", "type": "string" }, "startTime": { "format": "date-time", "type": "string" }, "totalDailySnapshots": { "items": { "$ref": "#/components/schemas/VestingScheduleSnapshot" }, "type": "array" } }, "required": [ "allocations", "asset", "endTime", "startTime", "totalDailySnapshots" ], "type": "object" }, "AssetBasic": { "type": "object", "description": "Schema for AssetBasic", "properties": {}, "additionalProperties": true }, "UnlockEvent": { "type": "object", "description": "Schema for UnlockEvent", "properties": {}, "additionalProperties": true }, "VestingScheduleSnapshot": { "type": "object", "description": "Schema for VestingScheduleSnapshot", "properties": {}, "additionalProperties": true }, "UnlockSnapshot": { "type": "object", "description": "Schema for UnlockSnapshot", "properties": {}, "additionalProperties": true }, "AllocationTranche": { "type": "object", "description": "Schema for AllocationTranche", "properties": {}, "additionalProperties": true }, "AllocationVestingScheduleTranche": { "type": "object", "description": "Schema for AllocationVestingScheduleTranche", "properties": {}, "additionalProperties": true }, "AllocationUnlockTranche": { "type": "object", "description": "Schema for AllocationUnlockTranche", "properties": {}, "additionalProperties": true } }, "securitySchemes": { "apiKey": { "in": "header", "name": "X-Messari-API-Key", "type": "apiKey" } } } }