Gateway: TransferHistory

Get list of user's transfer history

REST API

Get a list of user's transfer history

GET https://cbridge-prod2.celer.app/v2/transferHistory

Here is a request sample:

https://cbridge-prod2.celer.app/v1/transferHistory?acct_addr[]=0x51D36E18E3D32d121A3CfE2F3E5771A6FD53274E&page_size=5&next_page_token=1639122153714

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

200: OK

{
  "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

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

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

TransferInfo

Name	Type
chain	Chain
token	Token
amount	String