Danogo
  • INTRODUCTION
    • Danogo
    • Litepaper
      • Danogo Fixed Pool Lending
      • Danogo Flexible Pool Lending
  • Follow Us
  • Blogs
    • Cardano Smart Contract Composability Challenges
    • Danogo Multi-Source Oracle Aggregation
    • Handle concurrency in a market crash
    • Fixed Pool Lending Early Adopter Rewards Program
    • Prevent LP Price Manipulation
    • Danogo Flexible Pool Incentivized Testnet
  • HOW TO USE
    • Getting Started
      • Ready with your Cardano Wallet
      • Connecting Wallet
    • Guides
      • Yield Aggregator
        • How to find the most suitable yield products?
        • How to Supply Liquidity?
        • How to Withdraw Liquidity?
        • How to Borrow Tokens?
        • How to Repay a Loan?
      • Danogo Staking Bond
        • How to Borrow ADA Staking Rights?
        • How to Provide Liquidity?
      • Danogo Bond Dex
        • How to buy a Bond at Market price?
        • How to buy a Bond at your desired price (create Buy order)
        • How to sell a Bond at Market price?
        • How to sell a Bond at your desired price? (create Sell order)
        • How to update Sell order (Listing)?
      • Fixed Pool Lending
        • How to Create a Pool
        • How to Create a Loan
        • How To Repay a Loan
        • Top-up Collateral
        • How To Redeem
        • How To Perform Mass Liquidation
      • Flexible Pool Lending
        • How To Supply Assets
        • How To Withdraw Assets
        • How To Borrow
        • How To Modify Loans
        • How To Repay Loan
    • Video Guides
    • FAQ
      • Danogo Dex
      • Danogo Staking Bond
      • Yield Aggregator
      • Fixed Pool Lending
  • Developers
    • Integration
      • How to build transaction to create a fixed rate loan
      • APIs
        • Loan
        • Utility
        • Models
Powered by GitBook
On this page
  1. Developers
  2. Integration
  3. APIs

Loan

PreviousAPIsNextUtility
  • POSTGet available loans
  • POSTGet Params for Create Fixed Rate Loan transaction
  • POSTGet Params for Create Float Rate Loan transaction

Get available loans

post
  • Get all available loan offers, filter by loan tokens, collateral tokens, loan maturity and pagination with page/pageSize

Body
all ofOptional
Responses
200
Success
application/json
Responseall of
default
An unexpected error response
application/json
post
POST /api/v1/get-available-loans HTTP/1.1
Host: danogo-lending.preview.tekoapis.net
Content-Type: application/json
Accept: */*
Content-Length: 221

{
  "loanTokens": [
    "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e"
  ],
  "collateralTokens": [
    "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e"
  ],
  "loanMaturity": 1731715200000,
  "page": 1,
  "pageSize": 10
}
{
  "code": 1,
  "traceId": "text",
  "message": "text",
  "data": {
    "loans": [
      {
        "loanToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
        "loanOffers": [
          {
            "poolId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
            "borrowRate": 5000,
            "loanDuration": 7,
            "minBorrowAmount": "2000000",
            "availableLiquidity": "1234567",
            "collaterals": [
              {
                "collateralToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
                "liquidationThreshold": 8100
              }
            ]
          }
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 1
    }
  }
}

Get Params for Create Fixed Rate Loan transaction

post
  • Get parameters for Create Fixed Rate Loan Transaction

  • Documentation: https://docs.danogo.io/developers/integration/how-to-build-transaction-to-create-a-fixed-rate-loan

Body
poolIdstring · {policyId}.{assetName}Required

Token id of the Pool NFT from which the Loan will borrow

Example: 29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e
borrowAmountstring · bigintRequired

Amount of token to borrow, in base unit

Example: 10000000000
loanDurationintegerRequired

Loan duration in days

Example: 7
Responses
200
Success
application/json
Responseall of
default
An unexpected error response
application/json
post
POST /api/v1/get-create-fixed-loan-params HTTP/1.1
Host: danogo-lending.preview.tekoapis.net
Content-Type: application/json
Accept: */*
Content-Length: 253

{
  "poolId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
  "borrowAmount": "10000000000",
  "loanDuration": 7,
  "collaterals": [
    {
      "collateralToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
      "collateralAmount": "1231354"
    }
  ]
}
{
  "code": 1,
  "traceId": "text",
  "message": "text",
  "data": {
    "inputs": {
      "liqwidInUtxo": {
        "outRef": "884b4ba2436aac16bc38d667a19ae2cba2f2bc3e30235e07e47c7c2cda817182#0",
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ]
      },
      "poolInUtxo": {
        "outRef": "884b4ba2436aac16bc38d667a19ae2cba2f2bc3e30235e07e47c7c2cda817182#0",
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ]
      }
    },
    "outputs": {
      "poolOutUtxo": {
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ],
        "datum": {
          "supplyToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
          "supplyYieldToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
          "circulatingPTSupply": "1000000000",
          "circulatingYTSupply": "1000000000",
          "supplyMaturity": 1234567890,
          "baseInterestRate": 2000,
          "gradient": 1100,
          "maxLoanDuration": 15552000000,
          "activeLoanCount": 1,
          "minBorrowAmount": "2000000",
          "collaterals": [
            {
              "collateralToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
              "liquidationThreshold": 8100
            }
          ]
        }
      },
      "loanOutUtxo": {
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ],
        "datum": {
          "loanAmount": "1000000000",
          "loanMaturity": 1234567890,
          "loanOwnerNft": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
          "minAda": "2000000"
        }
      },
      "feeOutUtxo": {
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ]
      },
      "liqwidOutUtxo": {
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ],
        "datum": {
          "supplyChanged": "90000000",
          "mintChanged": "123123123123",
          "principal": "100000000",
          "interest": "12345",
          "minInterest": "800000",
          "poolIndex": "123"
        }
      }
    },
    "withdrawal": {
      "rewardAddressScriptHash": "f0e22afe38c8a48cd86f871cd0fd27cbb8deca4da76d8c06cb8f3c41bf",
      "coin": "2000000",
      "withdrawalRedeemer": {
        "prices": [
          {
            "borrowToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
            "oraclePrices": {
              "collateralToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
              "priceNum": "1231354",
              "priceDen": "1000000"
            }
          }
        ],
        "borrowRates": [
          {
            "yieldToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
            "borrowRate": "5000"
          }
        ]
      }
    },
    "mint": {
      "multiAssets": [
        {
          "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
          "assets": [
            {
              "name": "4d494e",
              "value": "123123123"
            }
          ],
          "redeemerType": "FIXED"
        }
      ]
    },
    "referenceInputs": [
      {
        "outRef": "884b4ba2436aac16bc38d667a19ae2cba2f2bc3e30235e07e47c7c2cda817182#0",
        "type": "POOL_SCRIPT"
      }
    ],
    "auxiliaryData": {
      "loanOwnerNftMetadata": {
        "name": "pDJED",
        "image": "ipfs://bafybeidx7wy2bclp6bhbvbmtuwmhx4jvrvt6lrbntinjyxlte47kwh63",
        "description": "qADA is an interest bearing token minted upon deposit into the Liqwid ADA market and burned when redeemed."
      }
    }
  }
}

Get Params for Create Float Rate Loan transaction

post

Get parameters for Create Float Rate Loan Transaction

Body
borrowTokenstring · {policyId}.{assetName}Required

Token id, concat of asset policyId with asset name (Case ADA, id = "")

Example: 29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e
borrowAmountstring · bigintRequired

Amount of token to borrow, in base unit

Example: 10000000000
Responses
200
Success
application/json
Responseall of
default
An unexpected error response
application/json
post
POST /api/v1/get-create-float-loan-params HTTP/1.1
Host: danogo-lending.preview.tekoapis.net
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "borrowToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
  "borrowAmount": "10000000000",
  "collaterals": [
    {
      "collateralToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
      "collateralAmount": "1231354"
    }
  ]
}
{
  "code": 1,
  "traceId": "text",
  "message": "text",
  "data": {
    "inputs": {
      "liqwidInUtxo": {
        "outRef": "884b4ba2436aac16bc38d667a19ae2cba2f2bc3e30235e07e47c7c2cda817182#0",
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ]
      },
      "poolInUtxo": {
        "outRef": "884b4ba2436aac16bc38d667a19ae2cba2f2bc3e30235e07e47c7c2cda817182#0",
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ]
      }
    },
    "outputs": {
      "poolOutUtxo": {
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ],
        "datum": {
          "totalSupply": "100009399400",
          "circulatingDToken": "134344444554",
          "totalBorrow": "100009399400",
          "borrowRate": 5000,
          "interestIndex": "12000000000",
          "interestTime": 1745028479000,
          "undistributedFee": "100009399400",
          "dTokenRateNum": "12000300003",
          "dTokenRateDen": "12000000000",
          "alternativeSupplyTokens": [
            {
              "token": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
              "latestExchangeRateNum": "13000000000",
              "latestExchangeRateDen": "12000000000"
            }
          ]
        }
      },
      "loanOutUtxo": {
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ],
        "datum": {
          "loanToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
          "loanOwnerToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
          "loanAmount": "10000000000",
          "initialInterestIndex": "12000000000"
        }
      },
      "feeOutUtxo": {
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ]
      },
      "liqwidOutUtxo": {
        "address": "addr1q8ql0key4tj6gqq707rjwqpm26h5swmsjdgcma6u9qjj5xk722ldtah02wt8x9ccvm5qzjt099ctyd0fxlj0r8wsgyqskj6066",
        "coin": "2000000",
        "multiAssets": [
          {
            "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
            "assets": [
              {
                "name": "4d494e",
                "value": "123123123"
              }
            ]
          }
        ],
        "datum": {
          "supplyChanged": "90000000",
          "mintChanged": "123123123123",
          "principal": "100000000",
          "interest": "12345",
          "minInterest": "800000",
          "poolIndex": "123"
        }
      }
    },
    "withdrawal": {
      "rewardAddressScriptHash": "f0e22afe38c8a48cd86f871cd0fd27cbb8deca4da76d8c06cb8f3c41bf",
      "coin": "2000000",
      "withdrawalRedeemer": {
        "prices": [
          {
            "borrowToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
            "oraclePrices": {
              "collateralToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
              "priceNum": "1231354",
              "priceDen": "1000000"
            }
          }
        ],
        "borrowRates": [
          {
            "yieldToken": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6.4d494e",
            "borrowRate": "5000"
          }
        ]
      }
    },
    "mint": {
      "multiAssets": [
        {
          "policyId": "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6",
          "assets": [
            {
              "name": "4d494e",
              "value": "123123123"
            }
          ],
          "redeemerType": "FIXED"
        }
      ]
    },
    "referenceInputs": [
      {
        "outRef": "884b4ba2436aac16bc38d667a19ae2cba2f2bc3e30235e07e47c7c2cda817182#0",
        "type": "POOL_SCRIPT"
      }
    ]
  }
}