Explorer API

Overview

The Mayan Explorer API provides a powerful interface to track and monitor cross-chain swaps executed on the Mayan protocol. It delivers comprehensive transaction data for users and developers seeking detailed insights into swap lifecycle and status.

Interactive API Documentation

For users and developers who want to explore and test the Mayan API endpoints directly, we provide a Swagger UI portal. This user-friendly interface allows you to view all available endpoints, try out queries in real-time, and understand request and response formats without writing any code.

Swagger UI

Querying Transaction Status

Using the Explorer API, you can query transaction progress and details by providing the swap transaction hash. The API returns current statuses reflecting each step of the swap process.

Real-Time Monitoring and Auditing

This API enables real-time visibility into the entire swap journey, supporting auditing, error handling, and enriched user experience for frontends or backend integrations.

Example API Request

Here’s a sample request illustrating how to retrieve swap details using a transaction hash:

curl 'https://explorer-api.mayan.finance/v3/swap/trx/0xc16b8f11263636d1fc3d7fb69601b3efb1e101388e1ee21f286a9ac9a59e1f44'

Detailed Swap Information

The API response includes all relevant fields such as swap status, involved tokens and chains, amounts transferred, timestamps, fees, and verification receipts. Every field is always present, and fields that do not apply to the swap’s route are null. The example below is a Swift swap of USDT on BSC to SOL on Solana. It is abridged to the fields most integrations read; the full response has over a hundred fields.

{
  "id": "efe3f0b4-9a49-4488-b501-4aa0fca9dfab",
  "orderId": "SWIFT_V2_0x494d39226a493c62003d433091dd4916fd0018dd28d8ebcba84c2a01de005a3e",
  "service": "SWIFT_V2",
  "trader": "0x3b499dE0D68da997BC56651800A53F0ADe819ceD",
  "sourceTxHash": "0xc16b8f11263636d1fc3d7fb69601b3efb1e101388e1ee21f286a9ac9a59e1f44",
  "sourceChain": "4",
  "destChain": "1",
  "destAddress": "4fwY2VzDsPjZ787BbVnVEVbzRQ6noiwoGPAMPuRTERp1",
  "fromTokenSymbol": "USDT",
  "fromTokenAddress": "0x55d398326f99059ff775485246999027b3197955",
  "fromAmount": "18.8836523",
  "fromAmount64": "18883652300000000000",
  "toTokenSymbol": "SOL",
  "toTokenAddress": "0x0000000000000000000000000000000000000000",
  "toAmount": "0.18833998",
  "toAmount64": "188339980",
  "minAmountOut": "0.1873145",
  "gasDrop": "0",
  "status": "ORDER_SETTLED",
  "clientStatus": "COMPLETED",
  "initiatedAt": "2026-10-27T08:01:57.000Z",
  "completedAt": "2026-10-27T08:02:04.000Z",
  "deadline": "2026-10-27T08:16:49.000Z",
  "fulfillTxHash": "zKfmrNikuBdqMkAZV3rgyXxpHK2GpWBQASj5ZymLcdnxVV7XtEorPUT9eb7G9bkKNgp13zYsStRhcZhvyrXeH9j",
  "redeemTxHash": null,
  "refundTxHash": null,
  "txs": [
    {
      "txHash": "0xc16b8f11263636d1fc3d7fb69601b3efb1e101388e1ee21f286a9ac9a59e1f44",
      "goals": ["SEND"],
      "scannerUrl": "https://bscscan.com/tx/0xc16b8f11263636d1fc3d7fb69601b3efb1e101388e1ee21f286a9ac9a59e1f44"
    },
    {
      "txHash": "3crMTYNooBmGfv76DnUCKzHGAYBXDwGNSEnh5LsSEcjuJVnnynoM4GMTJbWBKmkE14EX2ujjmECGkJumKQHi5GzG",
      "goals": ["FULFILL"],
      "scannerUrl": "https://solscan.io/tx/3crMTYNooBmGfv76DnUCKzHGAYBXDwGNSEnh5LsSEcjuJVnnynoM4GMTJbWBKmkE14EX2ujjmECGkJumKQHi5GzG"
    },
    {
      "txHash": "zKfmrNikuBdqMkAZV3rgyXxpHK2GpWBQASj5ZymLcdnxVV7XtEorPUT9eb7G9bkKNgp13zYsStRhcZhvyrXeH9j",
      "goals": ["SETTLE"],
      "scannerUrl": "https://solscan.io/tx/zKfmrNikuBdqMkAZV3rgyXxpHK2GpWBQASj5ZymLcdnxVV7XtEorPUT9eb7G9bkKNgp13zYsStRhcZhvyrXeH9j"
    },
    {
      "txHash": "YUeKhAmzWBQiEZu9fKuMZurKcXqqWG7xHMFhUk7D8mkGkqrwJtg2Cycx8uLgw5Yiry1ZKb843MGhDVad4r1VAP7",
      "goals": ["REGISTER_ORDER"],
      "scannerUrl": "https://solscan.io/tx/YUeKhAmzWBQiEZu9fKuMZurKcXqqWG7xHMFhUk7D8mkGkqrwJtg2Cycx8uLgw5Yiry1ZKb843MGhDVad4r1VAP7"
    }
  ]
}

Build your interface on clientStatus, which is INPROGRESS until the swap reaches a final state. fulfillTxHash is the destination-chain transaction that delivered the output, and txs lists every transaction in the swap with a block explorer link in scannerUrl. See Track Transactions for how to handle each status.

GET STARTED

USE CASES

SOLUTIONS

HOW MAYAN WORKS

FEATURES

INTEGRATION

RESOURCES

AI AGENTS

Explorer API

Overview

Interactive API Documentation

Swagger UI

Querying Transaction Status

Real-Time Monitoring and Auditing

Example API Request

Detailed Swap Information

​Overview

​Interactive API Documentation

Swagger UI

​Querying Transaction Status

​Real-Time Monitoring and Auditing

​Example API Request

​Detailed Swap Information

Overview

Interactive API Documentation

Querying Transaction Status

Real-Time Monitoring and Auditing

Example API Request

Detailed Swap Information