Supported Chains
Available on Ethereum, Arbitrum, Base and Optimism
Available Endpoints:
Click on the endpoint to jump to the section with full details
/getbalance GET
-Get balance of the user in a given Vault.
/getvaults GET
- Get the number of the vaults along with the respective vault APY.
/depositvault GET
- Trigger the deposit transaction for the given vault.
/withdrawvault POST
- Trigger the withdraw transaction for the given vault.
Yield Aggregator IDs
Many endpoints have a parameter where you can provide a lendborrow ID.
Below is a list of lendborrow IDs related to Yearn Finance V2. Please see the Yield Aggregator ID for a complete Yield Aggregator ID list and more information.
Yield Aggregator Name
Chain
Yield Aggregator ID
Endpoint Details
/getbalance
For /getbalance , the user can either pass the vaultAddress or the tokenAddress and the vaultNumber along with the required parameters.
Get balance of the user in a given Vault.
GET
https://api.expand.network/yieldaggregator/getbalance
Query Parameters
Remote procedural call URL.
Public Address of the owner.
The number of the vault, incase there are multiple vaults.
The address of the vault.
Sample Request Sample Response
With tokenAddress:
Copy https://api.expand.network/yieldaggregator/getbalance?address=0xC7565379C190014449eE83CF9FD7475206E59f9e&tokenAddress=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&yieldAggregatorId=5000
With VaultAddress:
Copy https://api.expand.network/yieldaggregator/getbalance?address=0x6Fb447Ae94F5180254D436A693907a1f57696900&yieldAggregatorId=5000&vaultAddress=0xa9fE4601811213c340e850ea305481afF02f5b28
Copy {
"status" : 200 ,
"msg" : "success" ,
"data" : {
"vaultBalance" : "0"
}
}
/getvaults
Get the number of the vaults along with the respective vault APY.
GET
https://api.expand.network/yieldaggregator/getvaults
Query Parameters
Remote procedural call URL
Sample Request Sample Response
Copy https://api.expand.network/yieldaggregator/getvaults?tokenAddress=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&yieldAggregatorId=5000
Copy {
"status" : 200 ,
"msg" : "success" ,
"data" : {
"tokenVaults" : [
{
"vaultName" : "WETH yVault" ,
"vaultSymbol" : "yvWETH" ,
"vaultAddress" : "0xa9fE4601811213c340e850ea305481afF02f5b28" ,
"tokenAddress" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" ,
"apr" : {
"netAPR" : "0.00" ,
"weeklyAPR" : "0.00" ,
"monthlyAPR" : "0.00" ,
"inceptionAPR" : "0.00" ,
"estAPR" : "0.00" ,
"boost" : null
} ,
"fee" : {
"managementfee" : "0.00" ,
"performancefee" : "0.00"
} ,
"vaultNumber" : 0
} ,
{
"vaultName" : "WETH yVault" ,
"vaultSymbol" : "yvWETH" ,
"vaultAddress" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"tokenAddress" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" ,
"apr" : {
"netAPR" : "5.06" ,
"weeklyAPR" : "6.48" ,
"monthlyAPR" : "5.06" ,
"inceptionAPR" : "7.54" ,
"estAPR" : "5.06" ,
"boost" : null
} ,
"fee" : {
"managementfee" : "0.00" ,
"performancefee" : "20.00"
} ,
"vaultNumber" : 1
}
]
}
}
/depositvault
For /depositvault , the user can either pass the tokenAddress or the vaultAddress along with the required parameters.
Trigger the deposit transaction for the given vault.
POST
https://api.expand.network/yieldaggregator/depositvault
Request Body
The amount of token to deposit.
The address of the token.
Address of the sender of the token.
Maximum gas limit provided by the sender, for the transaction.
The number of the vault, in case there are multiple vaults.
The address of the vault.
Sample Request Sample Response
With tokenAddress:
Copy {
"from" : "0x63056E00436Da25BcF48A40dfBbDcc7089351006" ,
"tokenAddress" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" ,
"amount" : "500000" ,
"vaultNumber" : "1" ,
"yieldAggregatorId" : "5000" ,
"gas" : "2307200"
}
With VaultAddress:
Copy {
"from" : "0x63056E00436Da25BcF48A40dfBbDcc7089351006" ,
"vaultAddress" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"amount" : "500000" ,
"yieldAggregatorId" : "5000" ,
"gas" : "2307200"
}
Copy {
"status" : 200 ,
"msg" : "success" ,
"data" : {
"chainId" : "1" ,
"from" : "0x63056E00436Da25BcF48A40dfBbDcc7089351006" ,
"to" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"value" : "0" ,
"gas" : "2307200" ,
"data" : "0xb6b55f25000000000000000000000000000000000000000000000000000000000007a120" ,
"referenceId" : "f99a93a359114de8ba8ae20c2def4dd9"
}
}
Sample Request Sample Response
With gasPriority (medium)-
1. With tokenAddress:
Copy {
"from" : "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07" ,
"tokenAddress" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" ,
"amount" : "10000000000" ,
"vaultNumber" : "1" ,
"yieldAggregatorId" : "5000" ,
"gas" : "2307200" ,
"gasPriority" : "medium"
}
2. With VaultAddress:
Copy {
"from" : "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07" ,
"vaultAddress" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"amount" : "500000" ,
"yieldAggregatorId" : "5000" ,
"gas" : "2307200" ,
"gasPriority" : "medium"
}
With gasPriority-
Copy {
"status" : 200 ,
"msg" : "success" ,
"data" : {
"chainId" : "1" ,
"from" : "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07" ,
"to" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"value" : "0" ,
"gas" : "2307200" ,
"data" : "0xb6b55f2500000000000000000000000000000000000000000000000000000002540be400" ,
"gasPrice" : "6492084170" ,
"referenceId" : "ba58ae00a7ba4899a1f1234e2e8f6b05"
}
}
/withdrawvault
For /withdrawvault , the user can either pass the tokenAddress or the vaultAddress along with the required parameters.
Trigger the withdraw transaction for the given vault.
POST
https://api.expand.network/yieldaggregator/withdrawvault
Request Body
Address of the withdrawer of the token.
Maximum gas limit provided by the sender, for the transaction.
The number of the vault, in case there are multiple vaults.
Sample Request Sample Response
With tokenAddress:
Copy {
"from" : "0x63056E00436Da25BcF48A40dfBbDcc7089351006" ,
"tokenAddress" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" ,
"amount" : "4881310" ,
"gas" : "2307200" ,
"vaultNumber" : "1" ,
"yieldAggregatorId" : "5000"
}
With vaultAddress:
Copy {
"from" : "0x63056E00436Da25BcF48A40dfBbDcc7089351006" ,
"vaultAddress" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"amount" : "4881310" ,
"gas" : "2307200" ,
"yieldAggregatorId" : "5000"
}
Copy {
"status" : 200 ,
"msg" : "success" ,
"data" : {
"chainId" : "1" ,
"from" : "0x63056E00436Da25BcF48A40dfBbDcc7089351006" ,
"to" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"value" : "0" ,
"gas" : "2307200" ,
"data" : "0x2e1a7d4d00000000000000000000000000000000000000000000000000000000004a7b9e" ,
"referenceId" : "4ea029bdeb874f9ba7866684a752875c"
}
}
Sample Request Sample Response
With gasPriority (high)-
1. With tokenAddress:
Copy {
"from" : "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07" ,
"tokenAddress" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" ,
"amount" : "10000000" ,
"gas" : "2307200" ,
"gasPriority" : "high" ,
"vaultNumber" : "1" ,
"yieldAggregatorId" : "5000"
}
2. With VaultAddress:
Copy {
"from" : "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07" ,
"vaultAddress" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"amount" : "4881310" ,
"gas" : "2307200" ,
"gasPriority" : "high" ,
"yieldAggregatorId" : "5000"
}
With gasPriority-
Copy {
"status" : 200 ,
"msg" : "success" ,
"data" : {
"chainId" : "1" ,
"from" : "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07" ,
"to" : "0xa258C4606Ca8206D8aA700cE2143D7db854D168c" ,
"value" : "0" ,
"gas" : "2307200" ,
"data" : "0x2e1a7d4d0000000000000000000000000000000000000000000000000000000000989680" ,
"gasPrice" : "7967445713" ,
"referenceId" : "6f60ed42ff354915a4785f4aea4c8b3a"
}
}
Last updated 3 months ago