{"id":28380657,"url":"https://github.com/0xsequence/token-directory","last_synced_at":"2025-06-24T21:31:27.689Z","repository":{"id":37854040,"uuid":"327349947","full_name":"0xsequence/token-directory","owner":"0xsequence","description":"Public dataset of ERC20, ERC721, ERC1155 token lists across many chains","archived":false,"fork":false,"pushed_at":"2025-06-04T09:28:06.000Z","size":5673,"stargazers_count":40,"open_issues_count":0,"forks_count":19,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-06-04T16:51:21.775Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xsequence.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-01-06T15:17:42.000Z","updated_at":"2025-06-04T09:28:06.000Z","dependencies_parsed_at":"2024-01-13T03:56:12.467Z","dependency_job_id":"ac16bc9c-ecf8-4a75-b24d-c8d8b6def197","html_url":"https://github.com/0xsequence/token-directory","commit_stats":{"total_commits":174,"total_committers":12,"mean_commits":14.5,"dds":0.7873563218390804,"last_synced_commit":"cf54ee8d34ab764336472d776fe44437612827bc"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/0xsequence/token-directory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Ftoken-directory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Ftoken-directory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Ftoken-directory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Ftoken-directory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xsequence","download_url":"https://codeload.github.com/0xsequence/token-directory/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Ftoken-directory/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261759102,"owners_count":23205496,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-30T03:09:01.374Z","updated_at":"2025-06-24T21:31:27.680Z","avatar_url":"https://github.com/0xsequence.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"Sequence Token Directory\n========================\n\nToken directory that contains a comprehensive list of ERC-20, ERC-721, ERC-1155 and other contracts.\n\n**NOTES:**\n* The [./index/index.json](./index/index.json) is an auto-generated file that is a master index of all ./index/**/* contents\nincluding chain names, chain ids, file names, and sha256 hashes of the file contents. This file\nis perfect for using as the primary index of this repo, and when syncing contents you can traverse this\nindex file and also compare the sha256 hash if the file has changed.\n* The [./index/deprecated.json](./index/deprecated.json) is a manually maintained file which lists all folders which are deprecated\nand as a result the files will be labelled as deprecated in the master index.json.\n* The [./index/external.json](./index/external.json) is a manually maintained file of external token list sources which are synced\nand downloaded to the [./index/_external](./index/_external) folder. We store the contents here to ensure data integrity,\nand we also compute and include these files in the master index.json.\n\n**REMINDERS:**\n* `pnpm reindex` is automatically called as a pre-commit hook anytime an entry it changed. You may also\ncall it manually if you like.\n* `pnpm sync-external` must be called manually periodically to ensure we have the latest contents, this\nscript is not run automatically.\n\n\n## Setup \n\n* `pnpm install` will setup your local tools\n* `pnpm reindex` to reindex the token directory master index.json, but see notes above, as this\nis also automatically called as a pre-commit hook.\n* `pnpm sync-external` to sync ./index/external.json files to local ./index/_external/ folder.\n\n## Token List Formats\n\nThe ERC-20 token lists present in this repository follow the [Uniswap Token List Schema](https://github.com/Uniswap/token-lists). The original list was populated using [Coingecko](https://www.coingecko.com/en)'s erc20 token list [CoinGecko](https://tokens.coingecko.com/uniswap/all.json). Token description and links are taken from Coingecko's API.\n\nThe ERC-721 and ERC-1155 token lists present in this repository follow the [Sequence Collectible List Schema](https://github.com/0xsequence/collectible-lists). \n\n\n## How to Add or Update Your Token / Contract\n\nIf a token is missing entirely, or contains incorrect or missing information, please stick to the following procedure;\n\n1. Fork this repository\n2. git clone, then: `pnpm install` to setup local tools\n3. Add your entry directly inside of `./index/\u003cchain\u003e/\u003cstandard\u003e.json`\n4. [Open a PR](https://github.com/0xsequence/token-directory/compare) comparing the master branch with your fork\n5. In the PR, add an explanation if this PR is for an existing token that needs to be updated\n\n\n## Formats\n\nDepending on the standard, your token entries should respect the following format:\n\n### ERC20\n\nSee [here](https://github.com/0xsequence/token-directory/blob/master/index/mainnet/erc20.json) for examples.\n\n```typescript\n{\n  chainId: number,         // Chain ID \n  address: string,         // Contract address\n  name: string,            // Name of token, 40 chars max\n  symbol: string,          // Symbol of token, 20 chars max\n  decimals: number,        // Number of decimals token uses\n  logoURI: string | null,  // URI / URL for token logo \n  extensions: {\n    link: string | null,        // URL of token's website\n    description: string | null, // Short description of token (1000 chars max)\n    ogImage: string | null      // URL of Open Graph image of token website \n}\n```\n\n### ERC721 and ERC1155\n\nSee [here](https://github.com/0xsequence/token-directory/blob/master/index/mainnet/erc721.json) for erc721 and [here](https://github.com/0xsequence/token-directory/blob/master/index/mainnet/erc1155.json) for erc1155 examples.\n\n```typescript\n{\n  chainId: number,                // Chain ID \n  address: string,                // Contract address\n  name: string,                   // Name of token, 40 chars max\n  standard: 'erc721' | 'erc1155', // Name of token's standard \n  symbol: string | null,          // Symbol of token, 20 chars max\n  logoURI: string | null,         // URI / URL for token logo\n  extensions: {\n    link: string | null,        // URL of token's website\n    description: string | null, // Short description of token (1000 chars max)\n    ogImage: string | null      // URL of Open Graph image of token website \n}\n```\n\n## LICENSE\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xsequence%2Ftoken-directory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xsequence%2Ftoken-directory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xsequence%2Ftoken-directory/lists"}