Gateway: TransferHistory
REST API
Get a list of user’s transfer history
GET https://cbridge-prod2.celer.app/v2/transferHistory
Here is a request sample:
Path Parameters
| Name | Type | Description |
|---|---|---|
| acct_addr* | String[] | User’s wallet addresses |
| next_page_token | String | Timestamp |
| page_size* | Int | size for history items, should be greater than 0 |
{
"err": null,
"history": [
],
"next_page_token": "0",
"current_size": "0"
}
GRPC-Web API
// import transfer history request message
import {
TransferHistoryRequest
} from "../ts-proto/sgn/gateway/v1/gateway_pb";
// import grpc-web WebClient
import {
WebClient
} from "../ts-proto/sgn/gateway/v1/GatewayServiceClientPb";
const request = new TransferHistoryRequest();
request.setNextPageToken("1639122153714");
request.setAcctAddrList(["0x51D36E18E3D32d121A3CfE2F3E5771A6FD53274E"]);
request.setPageSize(5);
const client = new WebClient(`https://cbridge-prod2.celer.app`, null, null);
const response = await client.transferHistory(request, null);
Request Parameters
| Name | Type | Description |
|---|---|---|
| next_page_token | String | |
| page_size | Number | Size for history items, should be greater than 0. Otherwise, gateway will return an empty list |
| acct_addr | Array<String> | User’s wallet addresses |
Note: To get the latest histories, use empty string as next_page_token. Otherwise, use value given by response.
Response Parameters
| Name | Type | Description |
|---|---|---|
| history_list | Array<TransferHistory> | |
| next_page_token | String | |
| current_page_size | Number |
Note: If current_page_size in response is smaller than page_size in request, it means list has come to an end/
TransferHistory
| Name | Type | Description |
|---|---|---|
| transfer_id | String | |
| src_send_info | TransferInfo | |
| dst_received_info | TransferInfo | |
| ts | Number | |
| src_block_tx_link | String | |
| dst_block_tx_link | String | |
| status | TranserHistoryStatus | |
| refund_reason | XferStatus |