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

# Track Transaction

> Track the status of a transaction



## OpenAPI

````yaml api-reference/openapi.json post /v1/track-tx
openapi: 3.1.0
info:
  title: dKit API
  description: Cross-chain swap aggregation API
  contact:
    name: API Support
    email: support@dkit.xyz
  version: v1
servers:
  - url: https://api.dkit.xyz
    description: Production API server
  - url: https://staging-api.dkit.xyz
    description: Staging API server
security: []
tags:
  - name: Core Endpoints
    description: Primary swap operations for quotes and tracking
  - name: Service Endpoints
    description: Specific transaction and integrations services
  - name: Data Endpoints
    description: Information endpoints for tokens, rates, and network data
externalDocs:
  description: API Documentation
  url: https://docs.dkit.xyz
paths:
  /v1/track-tx:
    post:
      tags:
        - Service Endpoints
      summary: Track Transaction
      description: Track the status of a transaction
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TrackTxParams'
            examples:
              default:
                value:
                  hash: >-
                    0x67d8c9c1c9d0eb6b9c453e9394e11082e03cf85317c2e6bf675de08924624897
                  chainId: ARB
                summary: Track an Arbitrum transaction by hash
              Track Arbitrum transaction:
                value:
                  hash: >-
                    0x67d8c9c1c9d0eb6b9c453e9394e11082e03cf85317c2e6bf675de08924624897
                  chainId: ARB
                summary: Track an Arbitrum transaction by hash
              Track Ethereum transaction:
                value:
                  hash: >-
                    0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
                  chainId: ETH
                summary: Track an Ethereum transaction
              Track Bitcoin transaction:
                value:
                  hash: >-
                    3b7b92c84e5b8a8c9e8d7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c
                  chainId: BTC
                summary: Track a Bitcoin transaction
              Track Solana transaction:
                value:
                  hash: >-
                    5gQWxq8n5qUPYMDDqTfJbqKnBzVvRzPR2fTLCxHrCBkNrDpBv2FLPKqt7pE9sfQc
                  chainId: SOL
                summary: Track a Solana transaction
      responses:
        '200':
          description: Successful tracking response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TxStatusResponse'
              examples:
                Confirmed Arbitrum transaction:
                  value:
                    hash: >-
                      0x67d8c9c1c9d0eb6b9c453e9394e11082e03cf85317c2e6bf675de08924624897
                    chain: ARB
                    status: confirmed
                    confirmations: 12
                    blockHeight: 150234567
                    timestamp: 1704067200
                    from: '0x817bFA97Cc8E5Bfa499D401f43E3087B07AE96f9'
                    to: '0x111111125421ca6dc452d289314280a0f8842a65'
                    value: '0'
                    gasUsed: '185432'
                    gasPrice: '100000000'
                  summary: Confirmed 1inch swap transaction on Arbitrum
                Pending Ethereum transaction:
                  value:
                    hash: >-
                      0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
                    chain: ETH
                    status: pending
                    confirmations: 0
                    from: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7'
                    to: '0x9c3C9283D3e44854697Cd22D3Faa240Cfb032889'
                    value: '1000000000000000000'
                    gasUsed: '21000'
                    gasPrice: '30000000000'
                  summary: Pending Ethereum transaction
                Confirmed Bitcoin transaction:
                  value:
                    hash: >-
                      3b7b92c84e5b8a8c9e8d7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c
                    chain: BTC
                    status: confirmed
                    confirmations: 6
                    blockHeight: 820000
                    timestamp: 1704067200
                    from: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
                    to: bc1q34aq5drpuwy3wgl9lhup9892qp6svr8ldzyy7c
                    value: '10000000'
                    fee: '2500'
                  summary: Bitcoin transaction with 6 confirmations
        '400':
          description: >-
            Bad Request - The request was invalid or cannot be served. Check the
            error message for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '404':
          description: Not Found - The requested resource could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '500':
          description: Internal Server Error - An unexpected error occurred on the server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
components:
  schemas:
    TrackTxParams:
      type: object
      properties:
        hash:
          type: string
          description: Transaction hash to track
        chain:
          type: string
          enum:
            - ARB
            - AVAX
            - BASE
            - BSC
            - BTC
            - BCH
            - GAIA
            - DASH
            - DOGE
            - ETH
            - KUJI
            - LTC
            - MAYA
            - OP
            - DOT
            - FLIP
            - MATIC
            - XRD
            - THOR
            - SOL
            - ZEC
            - HYPE
          description: Chain code (e.g. ETH, BTC, SOL)
      required:
        - hash
        - chain
    TxStatusResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - not_found
            - pending
            - confirmed
            - failed
            - replaced
        txHash:
          type: string
        chain:
          type: string
          enum:
            - ARB
            - AVAX
            - BASE
            - BSC
            - BTC
            - BCH
            - GAIA
            - DASH
            - DOGE
            - ETH
            - KUJI
            - LTC
            - MAYA
            - OP
            - DOT
            - FLIP
            - MATIC
            - XRD
            - THOR
            - SOL
            - ZEC
            - HYPE
          description: Chain code (e.g. ETH, BTC, SOL)
        trackMeta:
          type: object
          properties:
            chainflip:
              type: object
              properties:
                swapId:
                  type: string
                depositChannel:
                  type: object
                  properties:
                    id:
                      type: string
                    depositAddress:
                      type: string
                  required:
                    - id
                    - depositAddress
                  description: Chainflip deposit channel information
              required:
                - swapId
            evm:
              type: object
              properties:
                blockNumber:
                  type: number
                  description: Block number of the transaction
                confirmations:
                  type: number
                  description: Number of confirmations
                inboundAddress:
                  type: string
                  description: Inbound address (transaction.to)
                memo:
                  type: string
                  description: Decoded memo from transaction data
            outputTxHash:
              type: string
      required:
        - status
        - txHash
        - chain
    ValidationError:
      type: object
      properties:
        type:
          type: string
          enum:
            - /errors/validation-error
        title:
          type: string
          enum:
            - Validation Error
        status:
          type: number
          enum:
            - 400
        detail:
          type: string
        instance:
          type: string
        timestamp:
          type: string
          format: date-time
        traceId:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
              code:
                type: string
            required:
              - message
      required:
        - type
        - title
        - status
        - detail
    NotFoundError:
      type: object
      properties:
        type:
          type: string
          enum:
            - /errors/not-found
        title:
          type: string
          enum:
            - Resource Not Found
        status:
          type: number
          enum:
            - 404
        detail:
          type: string
        instance:
          type: string
        timestamp:
          type: string
          format: date-time
        traceId:
          type: string
      required:
        - type
        - title
        - status
        - detail
    InternalServerError:
      type: object
      properties:
        type:
          type: string
          enum:
            - /errors/internal-server-error
        title:
          type: string
          enum:
            - Internal Server Error
        status:
          type: number
          enum:
            - 500
        detail:
          type: string
          default: An unexpected error occurred
        instance:
          type: string
        timestamp:
          type: string
          format: date-time
        traceId:
          type: string
      required:
        - type
        - title
        - status

````