swapzone.io

{
  "name": "search_currencies",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search cryptocurrencies and blockchain assets supported by Swapzone. Use this tool when a user refers to an asset by its name, symbol, ticker, or blockchain/network and you need to determine the corresponding Swapzone ticker. Use it before searching for exchange offers when the user's asset or network is ambiguous or when the Swapzone ticker is not known.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "currency": {
        "type": "string",
        "description": "Ticker symbol of the cryptocurrency you want to find, e.g. BTC."
      }
    },
    "required": [
      "currency"
    ]
  }
}

{
  "name": "search_exchange_offers",
  "kind": "answer",
  "impl": "imperative",
  "description": "Find currently available cryptocurrency exchange offers on Swapzone.Use this tool when a user wants to exchange one cryptocurrencyfor another and wants to compare available exchange offers.The tool returns currently available offers from Swapzone'saggregated exchange providers, including estimated amountreceived, exchange rate, provider, fees, limits, rating,and estimated exchange time where available.Rates and availability may change. Do not represent anestimated amount as a guaranteed final amount.Use this tool for discovering and comparing exchange offers.Do not use it to initiate a transaction.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromCurrency": {
        "type": "string",
        "description": "Ticker symbol of the cryptocurrency the user wants to exchange, e.g. BTC."
      },
      "toCurrency": {
        "type": "string",
        "description": "Ticker symbol of the cryptocurrency the user wants to receive, e.g. USDT."
      },
      "amount": {
        "type": "string",
        "description": "Amount of the source cryptocurrency (tickerFrom) the user wants to exchange, represented as a decimal value."
      }
    },
    "required": [
      "fromCurrency",
      "toCurrency",
      "amount"
    ]
  }
}

{
  "name": "create_transaction",
  "kind": "transact",
  "impl": "imperative",
  "description": "Create a new cryptocurrency exchange transaction on Swapzone after the user has selected an exchange offer. This starts the transaction flow but does not complete the exchange or transfer funds.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromCurrency": {
        "type": "string",
        "description": "Swapzone ticker of the cryptocurrency the user wants to exchange, as returned by the selected exchange offer."
      },
      "toCurrency": {
        "type": "string",
        "description": "Swapzone ticker of the cryptocurrency the user wants to receive, as returned by the selected exchange offer."
      },
      "toNetwork": {
        "type": "string",
        "description": "Swapzone network of the cryptocurrency the user wants to receive, as returned by the selected exchange offer."
      },
      "amountDeposit": {
        "type": "string",
        "description": "Amount of fromCurrency the user wants to exchange, as specified by the user."
      },
      "quotaId": {
        "type": "string",
        "description": "The exact 'quotaId' of the exchange offer selected by the user from the search_exchange_offers tool."
      },
      "email": {
        "type": "string",
        "description": "Optional email address for receiving information about the transaction and Swapzone communications."
      },
      "addressReceive": {
        "type": "string",
        "description": "Wallet address where the user wants to receive the toCurrency. The address must be compatible with the selected destination cryptocurrency and network."
      },
      "refundAddress": {
        "type": "string",
        "description": "Wallet address where the user wants to receive a refund of the fromCurrency if a refund is required. The address must be compatible with the source cryptocurrency and network."
      },
      "offerReferenceId": {
        "type": "string",
        "description": "The exact 'offerReferenceId' from the exchange offer selected by the user from the search_exchange_offers tool."
      },
      "promocode": {
        "type": "string",
        "description": "Optional Swapzone promo code provided by the user. Do not invent or guess a promo code."
      }
    },
    "required": [
      "fromCurrency",
      "toCurrency",
      "toNetwork",
      "quotaId",
      "amountDeposit",
      "addressReceive",
      "refundAddress"
    ]
  }
}

{
  "name": "transaction_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get the current status and details of a Swapzone cryptocurrency exchange transaction. Use this tool to check a transaction previously created with the create_transaction tool, using the transaction ID returned by that tool. The transaction status describes Swapzone's processing state; a finished transaction may still take additional time to appear in the user's wallet or application.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "transactionId": {
        "type": "string",
        "description": "The transaction ID returned by the create_transaction tool."
      }
    },
    "required": [
      "transactionId"
    ]
  }
}