> ## 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.

# Check token ownership

> 
    Checks if a user owns a specific token by querying token balances across chains.
    Returns ownership status and balance with caching for performance.
  



## OpenAPI

````yaml post /check-token-ownership
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:
  /check-token-ownership:
    post:
      tags:
        - Tokens
      summary: Check token ownership
      description: |2-

            Checks if a user owns a specific token by querying token balances across chains.
            Returns ownership status and balance with caching for performance.
          
      operationId: checkTokenOwnership
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckTokenOwnershipRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckTokenOwnershipResponse'
        '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:
    CheckTokenOwnershipRequest:
      type: object
      properties:
        token_id:
          type: string
          format: uuid
        user_address:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}$
        user_id:
          type: string
          format: uuid
      required:
        - token_id
        - user_address
    CheckTokenOwnershipResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        is_holder:
          type: boolean
        balance:
          type: number
        cached:
          type: boolean
      required:
        - success
        - is_holder
        - balance
    Error:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: string
      required:
        - success
        - error
      description: Error response

````