> For the complete documentation index, see [llms.txt](https://effortless-labs.gitbook.io/hyperbola/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://effortless-labs.gitbook.io/hyperbola/token-contracts.md).

# Token Contracts

## Get token contracts by slug

> Retrieve contract information for a specific token identified by its slug.\
> Returns contract addresses and blockchain-specific deployment details.<br>

````json
{"openapi":"3.0.3","info":{"title":"Hyperbola Mesh API","version":"1.0.0"},"tags":[{"name":"Tokens","description":"🪙 **Cryptocurrency Token Operations**\n\nAccess comprehensive cryptocurrency token data including metadata, descriptions, and links.\n\n{% hint style=\"success\" %}\n**Popular Tokens**: Try searching for `bitcoin`, `ethereum`, `solana`, or `cardano` to get started.\n{% endhint %}\n\n{% tabs %}\n{% tab title=\"Search Tokens\" %}\nUse intelligent search with fuzzy matching to find tokens by name, symbol, or description.\n\n**Features:**\n- Exact matches (highest priority)\n- Prefix matching\n- Substring matching  \n- Fuzzy matching with Levenshtein distance\n{% endtab %}\n\n{% tab title=\"Lookup by Field\" %}\nGet tokens by specific fields like slug, symbol, or name for exact lookups.\n\n**Supported Fields:**\n- `slug`: Unique identifier (e.g., \"bitcoin\")\n- `symbol`: Token ticker (e.g., \"BTC\") \n- `name`: Full name (e.g., \"Bitcoin\")\n{% endtab %}\n{% endtabs %}\n\n{% openapi-schemas spec=\"index\" schemas=\"SearchToken\" grouped=\"false\" %}\n**Token Object Structure**\n\nThe SearchToken object contains essential information returned in search results.\n{% endopenapi-schemas %}\n"}],"servers":[{"url":"https://cell0.hyperbola.network","description":"🌟 Production Server (Recommended)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"**API Key Authentication**\n\nAll endpoints require a valid API key in the `x-api-key` header.\n\n**How to get your API key:**\n1. Contact the Hyperbola team at support@hyperbola.network\n2. Provide your use case and expected API usage\n3. Receive your unique API key via secure email\n\n**Using with Scalar/GitBook:**\n- Click the \"Test Request\" button on any endpoint\n- In the Authentication section, enter your API key\n- The key will be automatically added to all requests\n\n**Example:**\n```\nx-api-key: your-actual-api-key-here\n```\n\n**Security:**\n- Keep your API key secure and never expose it in client-side code\n- API keys are rate-limited and monitored for abuse\n- Contact support immediately if you suspect your key is compromised\n"}},"schemas":{"TokenContracts":{"type":"object","title":"Token Contract Addresses (Legacy)","description":"Contract addresses for a token across different blockchains (legacy format)","properties":{"slug":{"type":"string","description":"Token slug identifier"},"contracts":{"type":"object","description":"Contract addresses mapped by blockchain network name","additionalProperties":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Contract address on the specific blockchain"}}},"required":["slug","contracts"],"additionalProperties":false},"ValidationError":{"type":"object","title":"Validation Error Response","description":"Error response for request validation failures","properties":{"error":{"type":"object","description":"Validation error details","properties":{"message":{"type":"string","description":"General validation error message"},"fieldErrors":{"type":"object","description":"Field-specific validation errors","additionalProperties":{"type":"array","items":{"type":"string","maxLength":200}}}},"required":["fieldErrors"]}},"required":["error"],"additionalProperties":false},"Error":{"type":"object","title":"API Error Response","description":"Standard error response format","properties":{"error":{"type":"string","description":"Human-readable error message","maxLength":500},"code":{"type":"string","description":"Machine-readable error code"},"details":{"type":"object","description":"Additional error context and debugging information","additionalProperties":true}},"required":["error"],"additionalProperties":false}},"responses":{"BadRequestError":{"description":"Bad request - invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"UnauthorizedError":{"description":"Authentication required or invalid API key","content":{"text/plain":{"schema":{"type":"string"}}}},"NotFoundError":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooManyRequestsError":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/token/contracts/{slug}":{"get":{"summary":"Get token contracts by slug","description":"Retrieve contract information for a specific token identified by its slug.\nReturns contract addresses and blockchain-specific deployment details.\n","operationId":"getTokenContracts","tags":["Tokens"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Token slug identifier","schema":{"type":"string","pattern":"^[a-z0-9-]+$"}}],"responses":{"200":{"description":"Token contract information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenContracts"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"},"429":{"$ref":"#/components/responses/TooManyRequestsError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
````

## The TokenContracts object

```json
{"openapi":"3.0.3","info":{"title":"Hyperbola Mesh API","version":"1.0.0"},"components":{"schemas":{"TokenContracts":{"type":"object","title":"Token Contract Addresses (Legacy)","description":"Contract addresses for a token across different blockchains (legacy format)","properties":{"slug":{"type":"string","description":"Token slug identifier"},"contracts":{"type":"object","description":"Contract addresses mapped by blockchain network name","additionalProperties":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Contract address on the specific blockchain"}}},"required":["slug","contracts"],"additionalProperties":false}}}}
```