代币 API
3 分钟
代币API快速启动

[!小心]此产品目前处于测试阶段,正在积极开发中。如果您有任何反馈,请通过Discord联系我们。
The Graph的 代币API允许您通过 GET 请求访问区块链代币信息。 本指南旨在帮助您快速将 Token API 整合到您的应用程序中。
代币API提供了访问网链代币数据的机会,包括余额、持有人、详细的代币元数据和历史传输。 此 API 还使用 Model Context 协议 (MCP) 来丰富原始区块链数据,并通过使用 Claude 等的 AI 工具来丰富相关联的洞察力。
先决条件
在您开始之前,通过注册The Graph市场,获得一个 JWT 代币。 您可以使用下拉菜单为您的API密钥生成一个 JWT 代币。
认证
所有API端点都使用插入头中的JWT代币进行身份验证,该代币名为Authorization: Bearer <token>
。
1{2 "headers": {3 "Authorization": "Bearer eyJh•••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••NnlA"4 }5}
使用 JavaScript
使用 **JavaScript ** 做出API请求,添加请求参数,然后从相关的端点获取。例如:
index.js
1const address = '0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208'2const options = {3 method: 'GET',4 headers: {5 Accept: 'application/json',6 Authorization: 'Bearer <token>',7 },8}910fetch(`https://token-api.thegraph.com/balances/evm/${address}`, options)11 .then((response) => response.json())12 .then((response) => console.log(response))13 .catch((err) => console.error(err))
请务必用你的 API 密钥生成的 JWT 代币替换<token>
。
使用 cURL (命令行)
若要使用 cURL提出API请求,请打开您的命令行并运行以下命令。
1curl --request GET \2 --url https://token-api.thegraph.com/balances/evm/0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208 \3 --header 'Accept: application/json' \4 --header 'Authorization: Bearer <token>'
请务必用你的 API 密钥生成的 JWT 代币替换<token>
。
大多数类似Unix的系统都已预安装了 cURL 。对于Windows,您可能需要安装 cURL。
故障排除
如果API调用失败,请尝试打印完整的响应对象以获取额外的错误详细信息。例如:
index.js
1fetch(`https://token-api.thegraph.com/balances/evm/${address}`, options)2 .then((response) => {3 console.log('Status Code:', response.status)4 return response.json()5 })6 .then((data) => console.log(data))7 .catch((err) => console.error('Error:', err))