> ## Documentation Index > Fetch the complete documentation index at: https://tokenlayer-2a53bba4.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Search for token > Search for a token by: - **Token UUID** (internal token ID from tokens table) - **Token Layer ID** (bytes32 format: 0x... with 64 hex characters) - **Contract address** (0x... with 40 hex characters for EVM or base58 for Solana) - **Token symbol** (uppercase, e.g., BTC, ETH) - **Token slug** (url-friendly name, e.g., bitcoin, ethereum) Returns enriched token data including price, market cap, and holder count. ## OpenAPI ````yaml post /search-token openapi: 3.0.3 info: title: Thrust API version: 1.0.0 description: |2- Thrust is a social trading platform where users can create, trade, and engage with tokens. This API provides comprehensive access to token operations, social features (posts, voting, clubs), blockchain transactions, and real-time interactions. ## Base URL All endpoints are accessed via: `${SUPABASE_URL}/functions/v1/{endpoint}` ## Authentication Most endpoints require authentication using an JWT token or API key passed as a Bearer token in the Authorization header. ## Rate Limiting API calls are rate limited per user. Please implement appropriate backoff strategies. contact: name: Thrust API Support url: https://onthrust.com servers: - url: https://yppncslmsswqydhhgygz.supabase.co/functions/v1 description: Production server - url: https://yppncslmsswqydhhgygz.supabase.co/functions/v1 description: Staging server security: [] tags: - name: Tokens description: Token creation, browsing, search, trading, and price operations - name: Posts description: Creating and retrieving posts and topics - name: Voting description: Voting on posts, polls, tokens, and livestreams - name: Notifications description: User notifications management - name: Clubs description: Club and group management - name: Feed description: Timeline and feed operations - name: Transactions description: Blockchain transactions (send, tip, ownership checks) paths: /search-token: post: tags: - Tokens summary: Search for token description: |2- Search for a token by: - **Token UUID** (internal token ID from tokens table) - **Token Layer ID** (bytes32 format: 0x... with 64 hex characters) - **Contract address** (0x... with 40 hex characters for EVM or base58 for Solana) - **Token symbol** (uppercase, e.g., BTC, ETH) - **Token slug** (url-friendly name, e.g., bitcoin, ethereum) Returns enriched token data including price, market cap, and holder count. operationId: searchToken requestBody: content: application/json: schema: $ref: '#/components/schemas/SearchTokenRequest' responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/SearchTokenResponse' '400': description: Bad request - Invalid parameters content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: SearchTokenRequest: type: object properties: input: type: string minLength: 1 description: >- Token UUID, contract address (0x...), token layer ID (bytes32), symbol, or slug to search for example: 550e8400-e29b-41d4-a716-446655440000 required: - input SearchTokenResponse: type: object properties: success: type: boolean enum: - true token: allOf: - $ref: '#/components/schemas/Token' - type: object properties: price: type: number market_cap: type: number total_holder_count: type: number token_addresses: type: array items: $ref: '#/components/schemas/TokenAddress' description: Token with full metadata required: - success Error: type: object properties: success: type: boolean enum: - false error: type: string required: - success - error description: Error response Token: type: object properties: id: type: string format: uuid name: type: string symbol: type: string slug: type: string logo: type: string nullable: true format: uri banner_url: type: string nullable: true format: uri video_url: type: string nullable: true format: uri description: type: string token_layer_id: type: string nullable: true created_at: type: string format: date-time launch_post_id: type: string nullable: true format: uuid total_posts_count: type: integer minimum: 0 total_media_count: type: integer minimum: 0 groups_count: type: integer minimum: 0 holders_count: type: integer minimum: 0 upvotes: type: integer minimum: 0 downvotes: type: integer minimum: 0 weighted_upvotes: type: number minimum: 0 weighted_downvotes: type: number minimum: 0 user_vote: type: string nullable: true enum: - upvote - downvote is_live: type: boolean hashtags: type: array items: type: string creator: $ref: '#/components/schemas/User' required: - id - name - symbol - slug - logo - banner_url - video_url - description - token_layer_id - created_at - launch_post_id - total_posts_count - total_media_count - groups_count - holders_count - upvotes - downvotes - weighted_upvotes - weighted_downvotes - user_vote - is_live - hashtags - creator description: Token with full metadata TokenAddress: type: object properties: id: type: string format: uuid token_id: type: string format: uuid address: type: string address_display: type: string nullable: true address_type: type: string enum: - evm - sol chain: type: string platform_name: type: string is_registered: type: boolean dex_name: type: string nullable: true dex_address: type: string nullable: true created_at: type: string format: date-time required: - id - token_id - address - address_display - address_type - chain - platform_name - is_registered - dex_name - dex_address - created_at description: Token address on a specific blockchain User: type: object nullable: true properties: id: type: string format: uuid username: type: string profile_picture: type: string nullable: true format: uri required: - id - username - profile_picture description: User profile information ````