GuideReference
1.0.0
OAS 3.0.0

Mynth API

Welcome to the Mynth API documentation. Mynth Is a platform connecting Cardano to other blockchains, creating highways that enable seamless asset transfers. Our goal is to empower developers to build amazing Cardano applications using Mynth. We offer APIs that facilitate:

  • Swapping Cardano Native Tokens: Effortlessly swap tokens within the Cardano ecosystem.
  • Cross-Chain Swaps: Enable seamless asset transfers across different blockchains.
  • Babel Fees: Pay for transactions using native tokens, without needing to use ADA from user’s wallets.

This documentation provides an overview of the available endpoints.

Fee Sharing

A goal of Mynth is to allow anybody to build apps on Cardano easily. To encourage even more development, developers can earn a share of protocol revenue generated. Reach out to us on Discord to get started.

To earn revenue, you’ll need a service provider ID. This is a string that you’ll pass to endpoints that charge users fees to use. As a developer, you can define the fee to any value you’d like above a minimum value. Mynth charges a base fee for each action. Any difference between Mynth’s fee and the fee your user pays is the profit you get to keep.

At the end of each month, collected fees are tallied and distributed. Fees are paid out in MNT. If the fee was generated in a different token (e.g. MyUSD), then the amount of MNT received will be based on the market price at the time of distribution.

Mainnet server

None
Client Libraries
Curl Shell

Accounts​

Mynth offers liquid staking of MNT, MyUSD, and Chameleons, allowing users to earn staking rewards while maintaining full custody of their assets. There are no smart contract risks or lockups involved. Simply having these assets in your wallet is enough to start earning rewards, which are distributed at the end of each epoch.

To facilitate these interactions, Mynth provides several API endpoints for managing user accounts. Users can retrieve their current balances for MNT, MyUSD, and Chameleons, giving them a clear view of their holdings. Additionally, the API allows users to estimate their staking rewards based on their current asset holdings. Users can also easily withdraw their earned staking rewards.

Accounts Endpoints

/api/accounts/balances​

Retrieve balance details for a user’s account. This will include an overview of all of the user’s MNT, MyUSD and Chameleons. It will also show an estimation of rewards for the next epoch.

Query Parameters
  • address
    string
    required

    A Cardano address in bech32 format, including a staking credential

Responses
GET/api/accounts/balances


{
  "code": 200,
  "contents": {
    "balances": {
      "MNT": {
        "amount": "344.554166",
        "priceInAda": "0.286729",
        "priceInUSD": "0.118072",
        "valueInADA": "98.793671",
        "valueInUSD": "40.682246"
      },
      "MyUSD": {
        "amount": "10750.481023",
        "priceInAda": "2.428422",
        "priceInUSD": "1.000000",
        "valueInADA": "26106.707358",
        "valueInUSD": "10750.481023"
      },
      "chameleon": {
        "common": {
          "amount": 0,
          "priceInAda": "288.000000",
          "priceInUSD": "118.595520",
          "valueInADA": "0.000000",
          "valueInUSD": "0.000000"
        },
        "rare": {
          "amount": 1,
          "priceInAda": "349.000000",
          "priceInUSD": "143.714710",
          "valueInADA": "349.000000",
          "valueInUSD": "143.714710"
        }
      },
      "claimable": {
        "MNT": "344.554166",
        "MNTX": "344.554166",
        "MyUSD": "344.554166"
      }
    },
    "nextRewards": {
      "MNT": "8.409227"
    },
    "totalADA": "26554.501029",
    "totalStaked": {
      "MNT": "758084.377927",
      "chameleons": 1229
    },
    "totalUSD": "10934.877979"
  }
}

Balance details of a user's account

©2024 Progressive IT s.r.o.