Hot Cross Documentation
ApplicationAuditsTwitterUpdates
  • 📌What is Hot Cross?
  • Guides
    • 👋Getting Started
    • 🦺Audits
    • 🔑Access Portal
    • ✉️Contact
    • 🤩Ongoing Hot Cross Events!
      • 🧧Hot Cross Lunar New Year Celebration
      • 🏆Winners announcement for Lunar New Year Celebration
      • Liquidity Farming
      • Pending Prize Distribution
      • How to Supply HOTCROSS to earn lending interest?
      • How to Open a HOTCROSS long position with OpenLeverage?
      • How to Stake Cross Bosses get KALM
  • Products
    • ↔️Cross Connect
      • MetaMask
      • Trust Wallet
      • SafePal
      • WalletConnect
      • Frontier
      • Coin98 Wallet
      • Binance Wallet
      • TokenPocket
      • Math Wallet
      • BitKeep
      • iToken
    • 🖼️NFT Staking
    • 😎Cross Bosses
      • How to buy Cross Bosses on Liquid Collectibles
      • How to buy Cross Bosses on PancakeSwap
      • How to buy Cross Bosses on tofuNFT
      • How to buy Cross Bosses on Treasureland
      • How to buy Cross Bosses on NFTrade
      • How to buy Cross Bosses on Mintverse
    • 🌉Cross Bridge
    • 🏊‍♀️Cross Pool
    • 🎯Cross Send
    • 🙇‍♀️Know Your Customer
    • 🚀Initial Hot Cross Offerings
    • 📋Hot Cross User Dashboard
    • 🚜Cross Yield
    • 🎨Cross Mint
    • 🔓Cross Vest
    • 🔐Cross Claim
    • 🎇Cross API
      • Ecosystem Information
      • Supply Information for $HOTCROSS
      • User Information
      • Interact with Cross Yield
      • Interact with Cross Pool
      • HOTDOG Swap
      • NFT Staking
      • Initial Hot Cross Offerings
      • Utility API methods
  • Fundamentals
    • 💼Team
    • 💪Partners
    • 🤝Backers
    • ✅Roadmap
    • 🐷Hot Cross Token
    • 🌭Hot Dog Token
    • 🗣️Social
    • 🕶️Cadets
    • 🎏Brand Assets
Powered by GitBook
On this page
  • Create deposit Tx for Cross Yield
  • Create deposit tx for cross yield that will deposit the entire users balance
  • Create zap in Tx for cross yield
  • Create BNB zap in tx for Cross Yield
  • Create Cross Yield withdraw tx
  • Create Cross Yield withdraw all tx
  • Create Cross Yield harvest tx
  • Read user deposited amount from the blockchain
  • Read pending fees in WBNB that will be given as a reward to the user for harvesting
  1. Products
  2. Cross API

Interact with Cross Yield

PreviousUser InformationNextInteract with Cross Pool

Last updated 3 years ago

Create deposit Tx for Cross Yield

POST https://api.hotcross.com/cross-yield/{contractAddress}/tx/deposit

Path Parameters

Name
Type
Description

contractAddress*

String

The smart contract address of the cross yield vault

Request Body

Name
Type
Description

user*

String

The user account($EVM Address)

amount*

String

The amount the user wants to deposit (in the lowest denomination)

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

{
    "data": "0xb6b55f25000000000000000000000000000000000000000000000000000000000000000b",
    "gas": 719149
}
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

Create deposit tx for cross yield that will deposit the entire users balance

POST https://api.hotcross.com/cross-yield/{contractAddress}/tx/deposit-all

Path Parameters

Name
Type
Description

contactAddress*

String

The smart contract address of the cross yield vault

Request Body

Name
Type
Description

user*

String

The user account($EVM Address)

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

{
    "data": "0xde5f6268",
    "gas": 690738
}
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

Create zap in Tx for cross yield

POST https://api.hotcross.com/cross-yield/{contractAddress}/tx/zap-in

Path Parameters

Name
Type
Description

contractAddress*

String

The smart contract address of the cross yield vault

Request Body

Name
Type
Description

user*

String

The user account($EVM Address)

tokenInAmount*

String

The amount the user wants to zap in (in the lowest denomination)

crossYieldZapAddress*

String

The address of the cross yield zap contract

slippage*

number

A number representing a percentage for the maximum allowed slippage when performing the zap

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

{
    "data": "0x72f8b6cd0000000000000000000000009bff65a94c56f7173406f9b417b2bb81bf233965000000000000000000000000000000000000000000000000840a31eb4962a8e6000000000000000000000000bb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c000000000000000000000000000000000000000000000000002386f26fc10000",
    "gas": 721304
}
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

Create BNB zap in tx for Cross Yield

POST https://api.hotcross.com/cross-yield/{contractAddress}/tx/zap-in-bnb

Path Parameters

Name
Type
Description

contractAddress*

String

The smart contract address of the cross yield vault

Request Body

Name
Type
Description

user*

String

The user account($EVM Address)

tokenInAmount*

String

The amount the user wants to zap in (in the lowest denomination)

crossYieldZapAddress*

String

The address of the cross yield zap contract

slippage*

number

A number representing a percentage for the maximum allowed slippage when performing the zap

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

{
  "data": "string",
  "gas": 0
}
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

Create Cross Yield withdraw tx

POST https://api.hotcross.com/cross-yield/{contractAddress}/tx/withdraw

Path Parameters

Name
Type
Description

contractAddress*

String

The smart contract address of the cross yield vault

Request Body

Name
Type
Description

user*

String

The user account($EVM Address)

tokenAmount*

String

The amount of farming tokens the user wants to withdraw (in the lowest denomination). Only one of tokenAmount or ibtAmount needs to be included

ibtAmount*

String

The amount of IBT tokens the user wants to withdraw (in the lowest denomination). Only one of tokenAmount or ibtAmount needs to be included

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

{
    "data": "0x2e1a7d4d0000000000000000000000000000000000000000000000000000000000000064",
    "gas": 190448
}
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

Create Cross Yield withdraw all tx

POST https://api.hotcross.com/cross-yield/{contractAddress}/tx/withdraw-all

Path Parameters

Name
Type
Description

contractAddress*

String

The smart contract address of the cross yield vault

Request Body

Name
Type
Description

user*

String

The user account($EVM Address)

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

{
    "data": "0x853828b6",
    "gas": 325413
}
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

Create Cross Yield harvest tx

POST https://api.hotcross.com/cross-yield/{contractAddress}/tx/harvest

Path Parameters

Name
Type
Description

contractAddress*

String

The smart contract address of the cross yield strategy contract

Request Body

Name
Type
Description

user*

String

The user account($EVM Address)

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

{
  "user": "string",
  "chainId": 56
}
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

Read user deposited amount from the blockchain

POST https://api.hotcross.com/cross-yield/{contractAddress}/call/user-deposited

Path Parameters

Name
Type
Description

contractAddress*

String

The smart contract address of the cross yield vault

Request Body

Name
Type
Description

user*

String

The user account($EVM Address)

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

 4093514643865158608020
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

Read pending fees in WBNB that will be given as a reward to the user for harvesting

POST https://api.hotcross.com/cross-yield/{strategyAddress}/call/pending-fees

Path Parameters

Name
Type
Description

strategyAddress*

String

The smart contract address of the cross yield strategy contract

Request Body

Name
Type
Description

chainId*

number

The chain id of the blockchain you want to read the pools from Ethereum: 1 BNB Smart Chain: 56 Avalanche C-Chain: 43114

2783680589370196
{
    // Response
}

Returns

  • data - string: The call data of the transaction, can be empty for simple value transfers.

  • gas - number: The gas provided by the transaction

Postman example

🎇