sTRX API

API

获取 sTRX 市场信息

请求地址

/lend/strx

协议

HTTPS GET

header

无

公共参数

无

输入参数

无

返回值

参数	类型	含义
code	Integer	0 成功
message	String	描述信息
data	Map<String, Object>	StakeInfo 表示质押数据, RentInfo 表示租赁数据

StakeInfo

参数	类型	含义
strxAddress	String	sTRX 合约地址
symbol	String	sTRX
decimal	String	sTRX 精度
totalSupply	String	sTRX 供应量
totalSupplyUsd	String	sTRX 总价值 TVL
exchangeRate	String	sTRX 和 TRX 之间的兑换率， 1 个 sTRX 可以兑换的 TRX 数量
totalUnderlying	String	底层资产数量，即 TRX 数量
underlyingDecimal	String	底层资产精度，即 TRX 精度
rentReserveFactor	String	租赁收益的储备金因子
rewardReserveFactor	String	投票收益的储备金因子
reserves	String	储备金
supplyRate	String	质押年化收益率
trxPrice	String	TRX 美元价格

RentInfo

参数	类型	含义
rentMarketAddress	String	租赁市场合约地址
priceFor10KEnergByRent	String	租赁获取 1w 能量需要的 TRX 数量（不包含押金）
priceFor10KEnergByStake	String	质押获取 1w 能量需要的 TRX 数量
priceFor10KEnergByBurn	String	燃烧获取 1w 能量需要的 TRX 数量
totalDelegatedEnergyTrx	String	已租赁能量对应的 TRX 数量
totalDelegatedEnergyRate	String	资金利用率，即已经租赁的能量/市场总能量

输出示例

{
    "code":0,
    "data":{
        "rentInfo":{
            "priceFor10KEnergByBurn":"4.20000000",
            "priceFor10KEnergByRent":"0.10688361",
            "priceFor10KEnergByStake":"48.37391022",
            "rentMarketAddress":"TSos1xxjqMrGKBxycVmtgrnFvv9M6FDFUX",
            "totalDelegatedEnergyRate":"0.16762312",
            "totalDelegatedEnergyTrx":"20075.732341"
        },
        "stakeInfo":{
            "decimal":"18",
            "exchangeRate":"1.011404397263171363",
            "rentReserveFactor":"0.101234000000000000",
            "reserves":"168.336743",
            "rewardReserveFactor":"0.201230000000000000",
            "strxAddress":"TZ8du1HkatTWDbS6FLZei4dQfjfpSm9mxp",
            "supplyRate":"0.15633008",
            "symbol":"sTRX",
            "totalSupply":"246104.935152098442750529",
            "totalSupplyUsd":"16423.38430758",
            "totalUnderlying":"248911.613601",
            "trxPrice":"0.065980787597578113",
            "underlyingDecimal":"6"
        }
    },
    "message":"SUCCESS"
}

获取 sTRX 流动性质押的用户数据

请求地址

/lend/strxStake/account

协议

HTTPS GET

header

无

公共参数

无

输入参数

必填	参数	类型	默认值	含义
N	addresses	String	""	地址列表查询；有多个地址时用逗号分隔，默认表示全部地址
N	pageNo	int	1	查询页码，从 1 开始
N	pageSize	int	50	页大小
N	minStrxBalance	String	0	最小持有 sTRX 数量，即返回大于等于该值的用户数据

返回值

参数	类型	含义
code	Integer	0 成功
message	String	描述信息
data	Object	流动性质押的用户列表及相关数据

输出参数--StakeAccountInfo

参数	类型	含义
address	String	用户地址
sTRXBalance	String	sTRX 持有量
unstakingAmount	String	解冻中的 TRX 数量（不可提取）
availableWithdrawAmount	String	已解冻可提取的 TRX 数量

输出示例

{
    "code":0,
    "data":{
        "totalPage":10,
        "list":[
            {
                "address":"TZ8du1HkatTWDbS6FLZei4dQfjfpSm9mxp",
                "availableWithdrawAmount":"0",
                "unstakingAmount":"5627.831922",
                "sTRXBalance":"1.000000000000000000"
            },
            {
                "address":"TFj4syqrAQp545Xgaw8NDew79U6PUHVMBZ",
                "availableWithdrawAmount":"0",
                "unstakingAmount":"0",
                "sTRXBalance":"102.000000000052000000"
            }
        ],
        "totalCount":20
    },
    "message":"SUCCESS"
}

获取资源租赁的用户数据（目前仅支持能量租赁）

请求地址

/lend/rentResource/account

协议

HTTPS GET

header

无

公共参数

无

输入参数

必填	参数	类型	默认值	含义
N	addresses	String	""	地址列表查询；有多个地址时用逗号分隔，默认表示全部地址
N	pageNo	int	1	查询页码，从 1 开始
N	pageSize	int	50	页大小
N	minRentalAmount	String	0	最小质押量，即返回大于等于该值的用户数据
N	maxRemainingRentAmount	String	""	最大剩余租金，即返回剩余租金小于等于该值的用户数据，默认不做查询限制

返回值

参数	类型	含义
code	Integer	0 成功
message	String	描述信息
data	Object	质押的用户列表及相关数据

输出参数--RentAccountInfo

参数	类型	含义
renter	String	资源借出账户地址
receiver	String	资源接收账户地址
rentType	String	资源类型，目前仅为 "Energy"
delegatedAmount	String	质押量，单位 TRX
rentAmountPerDay	String	日租金，单位 TRX
rentRemainAmount	String	剩余租金，不包括押金，单位 TRX

输出示例

{
    "code":0,
    "data":{
        "totalPage":11,
        "list":[
            {
                "rentRemainAmount":"0.000000",
                "receiver":"TAvMRE6SL8aYYyVx5mHkEwBPvgD3FGSQND",
                "delegatedAmount":"0.000000",
                "rentAmountPerDay":"0.000000",
                "rentType":"Energy",
                "renter":"TAvMRE6SL8aYYyVx5mHkEwBPvgD3FGSQND"
            },
            {
                "rentRemainAmount":"984.830388",
                "receiver":"TKGRE6oiU3rEzasue4MsB6sCXXSTx9BAe3",
                "delegatedAmount":"5.000000",
                "rentAmountPerDay":"0.011048",
                "rentType":"Energy",
                "renter":"TCukPh41eQuicwc8wsqv9k6umMQ5esJD9d"
            }
        ],
        "totalCount":22
    },
    "message":"SUCCESS"
}