🌉
Celer cBridge
  • 👋Welcome to cBridge
  • Introduction
    • Architectural Benefits
    • State Guardian Network
    • SGN and cBridge
      • The SGN as a cBridge node gateway and Service Level Agreement (SLA) arbitrator
      • The SGN as a Shared Liquidity Pool Manager
    • Fungible Token Bridging Models
    • cBridge Security
  • Tutorial
    • Cross-chain Transfer
    • LP Guide
    • SGN V2 Staking Guide
    • SGN V1 Unbonding Guide
    • Smart Contract as LP
    • Aptos Bridging Guide
    • Ape Chain Bridging Guide
    • Flow Cadence Bridging Guide
    • Flow EVM Bridging Guide
  • Developer
    • Circle Cross-chain USDC Transfer Protocol(CCTP)
    • cBridge SDK
    • cBridge Pool-Based Transfer (xLiquidity)
      • Transfer
      • Transfer Refund
    • cBridge Canonical Mapping Transfer (xAsset)
      • Mint
      • Mint Refund
      • Burn
      • Burn Refund
    • cBridge Transfer Web Widget
    • cBridge Aptos Transfer (xAsset Only)
    • Custom Transfer URL Schemes
    • cBridge APIs for Sui
    • Referral Specific Transfer
    • cBridge Limit Parameters
    • API Reference
      • Gateway: GetTransferConfigsForAll
      • Gateway: EstimateAmt
      • Contract: Pool-Based Transfer
      • Gateway: GetTransferStatus
      • Contract: Pool-Based Transfer Refund
      • Gateway: TransferHistory
      • Contract: Mint Canonical Token(OriginalTokenVault)
      • Contract: Mint Canonical Token(OriginalTokenVaultV2)
      • Contract: Mint Canonical Token Transfer Refund
      • Contract: Burn Canonical Token(PeggedTokenBridge)
      • Contract: Burn Canonical Token (PeggedTokenBridgeV2)
      • Contract: Burn Canonical Token Transfer Refund
      • Gateway: MarkRefRelation
      • Contract: TransferAgent Mint Token Submission
      • Contract: TransferAgent Burn Token Submission
      • Contract: Aptos Vault Mint Token Submission
      • Contract: Aptos PegBridge Burn Token Submission
  • NFT Bridge
    • Introduction
    • NFT Bridge Fee
  • List Your Tokens
    • Simple Listing Process
  • Reference
    • FAQ
    • Audit Reports
    • Contract Addresses
Powered by GitBook
On this page
  • REST API
  • Get a list of user's transfer history
  • GRPC-Web API
  • Request Parameters
  • Response Parameters
  • TransferHistory
  • TransferInfo
  1. Developer
  2. API Reference

Gateway: TransferHistory

Get list of user's transfer history

PreviousContract: Pool-Based Transfer RefundNextContract: Mint Canonical Token(OriginalTokenVault)

Last updated 2 years ago

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

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

dst_received_info

ts

Number

src_block_tx_link

String

dst_block_tx_link

String

status

refund_reason

TransferInfo

Name
Type

chain

token

amount

String

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