What You’ll Learn
After completing this tutorial, you will be able to:- Create an application and obtain credentials
- Generate an Access Token for API authentication
- Call the API to get token metadata
- Understand the API response structure
Estimated time: 5-10 minutes
Prerequisites
- A registered ChainStream account (Register here)
Step 1: Create Application and Get Credentials
- Log in to ChainStream Dashboard
- Go to Applications
- Click Create New App
- After creation, you will get your
Client IDandClient Secret
Step 2: Generate Access Token
Use your credentials to generate an Access Token. The token is used for API authentication.- cURL
- JavaScript
- Python
Access Tokens are valid for 24 hours. You can generate a new token anytime using your credentials.
Step 3: Make Your First Request
Let’s use “Get Token Metadata” as an example. We’ll query information about the SOL token on Solana.- cURL
- JavaScript
- Python
Response Example
Step 4: Understand the Response
| Field | Type | Description |
|---|---|---|
chain | string | Blockchain network identifier |
decimals | integer | Token decimal places |
name | string | Token name |
symbol | string | Token symbol |
address | string | Token contract address |
imageUrl | string | Token logo URL |
tokenCreatedAt | integer | Token creation timestamp (milliseconds) |
For complete field descriptions, see the Token Metadata API Reference.
Step 5: Try More APIs
Now that you’ve successfully completed your first call, try these APIs:Get Token Price
Get real-time token price
GET /v1/token/{chain}/{tokenAddress}/priceGet Wallet Balance
Query wallet token holdings
GET /v1/wallet/{chain}/{walletAddress}/balanceCommon Issues
401 Unauthorized Error
401 Unauthorized Error
429 Too Many Requests Error
429 Too Many Requests Error
You’ve reached the request rate limit. The free tier is limited to 10 requests/second. You can upgrade your plan to increase the limit.See API Security for details.
How to query tokens on other chains?
How to query tokens on other chains?
Change the chain parameter in the URL, for example:
GET /v1/token/eth/{address}/metadata for EthereumGET /v1/token/bsc/{address}/metadata for BSCSee Realtime Streaming for the full list.Next Steps
Choose your next learning path based on your use case:Data Developer
Go to Data Concepts to understand data models
Compliance User
Go to Security Compliance to learn about KYT/KYA
AI Developer
Go to AI Infrastructure to learn about MCP integration
Having issues? Check the FAQ or contact technical support.

