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

/peggy/v1/batch REST API Endpoint

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