查询指定通道的未完成转账交易 - GET /api/(version)/pending_transfers/(token_address)/(partner_address)
返回指定通道的所有未完成的转账交易。
API请求
GET /api/(version)/pending_transfers/(token_address)/(partner_address)
URL参数:
- version:API版本号,目前可用:v1
- token_address:代币地址
- partner_address:对手方地址
API响应
返回一个JSON数组,每个交易对象包含以下字段:
- channel_identifier:通道标识符
- initiator:发起地址
- locked_amount:锁定金额
- payment_identifier:支付标识符
- role:交易中的角色
- target:目标地址
- token_address:代币地址
- token_network_identifier:代币网络标识符
- transferred_amount:转账金额
http响应的状态代码可能为以下值:
- 200 OK – 查询成功
- 404 Not Found – 未找到所查询的通道或代币
- 500 Internal Server Error – Raiden节点内部错误
示例代码
curl请求示例:
curl -i http://localhost:5001/api/v1/pending_transfers/0xd0A1E359811322d97991E03f863a0C30C2cF029C/0x2c4b0Bdac486d492E3cD701F4cA87e480AE4C685
响应结果如下:
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"channel_identifier": "255",
"initiator": "0x5E1a3601538f94c9e6D2B40F7589030ac5885FE7",
"locked_amount": "119",
"payment_identifier": "1",
"role": "initiator",
"target": "0x00AF5cBfc8dC76cd599aF623E60F763228906F3E",
"token_address": "0xd0A1E359811322d97991E03f863a0C30C2cF029C",
"token_network_identifier": "0x111157460c0F41EfD9107239B7864c062aA8B978",
"transferred_amount": "331"
}
]