Skip to main content

/peggy/v1/batch REST API Endpoint

Retrieves details of an outgoing transaction batch from the Peggy module to Ethereum, based on the provided nonce and ERC20 contract address.

Updated on
Jun 23, 2025

Query Parameters

nonce
string

The unique identifier for the transaction batch, used to look up a specific batch by its nonce

contract_address
string

The Ethereum address of the ERC20 contract associated with the transaction batch

Returns

batch
object

OutgoingTxBatch represents a batch of transactions going from Peggy to ETH

batch_nonce
string

A unique identifier for the batch used to prevent replay and ensure ordering

batch_timeout
string

A timestamp (or block height) after which the batch is considered invalid if not processed

transactions
array

List of transactions included in this outgoing batch

id
string

Unique identifier for the transaction in the batch

sender
string

Address of the Cosmos account that initiated the transfer

dest_address
string

Ethereum address where the tokens will be sent

erc20_token
object

ERC20Token unique identifier for an Ethereum ERC20 token which contains the following fields:

contract
string

Ethereum contract address of the ERC20 token being transferred

amount
string

Amount of tokens to be transferred, in string format to support large values

erc20_fee
object

ERC20 token fee for an Ethereum ERC20 token which contains the following fields:

contract
string

Ethereum contract address of the ERC20 token used to pay the fee

amount
string

Amount of fee tokens to be paid for processing this transaction

token_contract
string

Ethereum contract address of the token used across this batch

block
string

Cosmos block height at which the batch was created or submitted

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free