Getting Started
Our API offers a comprehensive suite of tools for labeling and analyzing blockchain wallet addresses. It’s designed to enrich your applications with detailed context and insights into blockchain transactions.
Base URL: https://api-c.walletlabels.xyz/
To begin using the WalletLabels API, you first need to obtain an API key. Please register here to get started.
WalletLabels API Reference
Authentication: Currently, there are no rate limits on API requests.
Headers:
x-api-key: demo-api-key-x-00000Label Data Structure
| Field | Type | Description |
|---|---|---|
| blockchain | String | Name of the blockchain network. |
| address | String | Blockchain address being labeled. |
| address_name | String | Human-readable name for the address. |
| label_type | String | Broad category of the label (e.g., ‘token’). |
| label_subtype | String | Specific categorization under the label type. |
| label | String | Concise label or tag for the address. |
| origin | String | Indicates where the labels have been imported from: current sources: arkham / etherscan / walletlabels. |
| source | String | Data Source of the label. |
Source Field Descriptions
| Data Source | Description |
|---|---|
| Ground Truth | This method verifies address ownership by conducting real transactions on the blockchain, ensuring the highest reliability and evidence-backed labeling. |
| External | Generated from external parties that are available to general public - e.g like Twitter, Discord, Etherscan, etc. |
| Heuristic | Utilizing data models built from historical transaction data, this approach clusters addresses based on transaction patterns, providing valuable insights despite lower certainty compared to ground truth. |
| Machine Learning | Leveraging machine learning algorithms with on/off-chain data, this method trains address clustering models for automated metadata generation, offering potential scalability and efficiency gains. |
Playground:
Test the API live in our playground. Try out different requests and see real-time responses.
Support and Community:
Join our Telegram community for support, discussions, and updates. Follow us on Twitter for the latest news.
Additional Resources:
API Key Registration: Get an API key
WalletLabels Home: Visit our website