> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leokit.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Trace

> Track your issue with Trace ID



## OpenAPI

````yaml /api-reference/openapi.json GET /trace/{traceId}
openapi: 3.0.3
info:
  title: Leokit API
  version: 1.0.0
  description: API reference for Leokit
servers:
  - url: https://api.leokit.dev
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /trace/{traceId}:
    get:
      summary: Get trace
      parameters:
        - name: traceId
          in: path
          required: true
          description: Trace identifier returned by the API when an error occurs.
          schema:
            type: string
            format: uuid
            default: 019b1a74-22c2-7000-ae23-f8ff1a788a41
          example: 019b1a74-22c2-7000-ae23-f8ff1a788a41
      responses:
        '200':
          description: Trace details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TraceResponse'
              example:
                id: 1
                created_at: '2025-12-14T01:22:57.482109+00:00'
                client_api: 54f67efd-dc72-47b1-aa85-81edeac76be2
                name: Error
                message: >-
                  invalid contract address or ENS name
                  (argument="addressOrName", value=undefined,
                  code=INVALID_ARGUMENT, version=contracts/5.8.0)
                code: INVALID_ARGUMENT
                method: POST
                url: /leokit/deposit
                stack: >-
                  Error: invalid contract address or ENS name
                  (argument=\"addressOrName\", value=undefined,
                  code=INVALID_ARGUMENT, version=contracts/5.8.0)\n    at
                  <anonymous>
                  (/Users/eren/Desktop/eren/leodex-backend/node_modules/@ethersproject/logger/lib/index.js:238:25)\n   
                  at <anonymous>
                  (/Users/eren/Desktop/eren/leodex-backend/node_modules/@ethersproject/logger/lib/index.js:247:20)\n   
                  at BaseContract
                  (/Users/eren/Desktop/eren/leodex-backend/node_modules/@ethersproject/contracts/lib/index.js:669:20)\n   
                  at new Contract
                  (/Users/eren/Desktop/eren/leodex-backend/node_modules/@ethersproject/contracts/lib/index.js:1053:42)\n   
                  at thorchain_buildUnsignedEvmTx
                  (/Users/eren/Desktop/eren/leodex-backend/utils/leokit/builders/evm/default.ts:122:38)\n   
                  at thorchain_buildUnsignedEvmTx
                  (/Users/eren/Desktop/eren/leodex-backend/utils/leokit/builders/evm/default.ts:100:3)\n   
                  at evmDepositHandler
                  (/Users/eren/Desktop/eren/leodex-backend/utils/leokit/deposit/evm.ts:51:20)\n   
                  at evmDepositHandler
                  (/Users/eren/Desktop/eren/leodex-backend/utils/leokit/deposit/evm.ts:17:40)\n   
                  at deposit
                  (/Users/eren/Desktop/eren/leodex-backend/utils/leokit/sdk.ts:132:36)\n   
                  at deposit
                  (/Users/eren/Desktop/eren/leodex-backend/utils/leokit/sdk.ts:119:24)
                trace_id: 019b1a74-22c2-7000-ae23-f8ff1a788a41
        default:
          $ref: '#/components/responses/ErrorResponse'
components:
  schemas:
    TraceResponse:
      type: object
      description: Trace record returned by /trace/{traceId}.
      required:
        - id
        - created_at
        - client_api
        - name
        - message
        - code
        - method
        - url
        - stack
        - trace_id
      properties:
        id:
          type: integer
          format: int64
          description: Internal trace record identifier.
        created_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp when the trace was created.
        client_api:
          type: string
          format: uuid
          description: Client API key/identifier associated with the request.
        name:
          type: string
          description: Short error name/category.
        message:
          type: string
          description: Human-readable error message.
        code:
          type: string
          description: Error code identifier (e.g., INVALID_ARGUMENT).
        method:
          type: string
          description: HTTP method of the original request (e.g., POST).
        url:
          type: string
          description: Request URL/path that produced the trace.
        stack:
          type: string
          description: Stack trace string captured from the error.
        trace_id:
          type: string
          format: uuid
          description: Trace identifier used to fetch this record.
    Error:
      type: object
      description: Generic error payload.
      properties:
        message:
          type: string
        code:
          type: string
  responses:
    ErrorResponse:
      description: Error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Api-Key
      description: 'Demo API-Key (Sandbox): 7037d2b3-9c76-4f62-b730-c544f7570fa4'

````