chain.deposit.v1.DepositAddressService

ListDepositAddresses

List known deposit addresses for one target on chains that currently accept deposits. Results are served from Polyester-owned state rather than a live upstream read.

Method

POST

Path

chain.deposit.v1.DepositAddressService/ListDepositAddresses

Service

chain.deposit.v1.DepositAddressService

Visibility

Authentication required

Authentication

Session token or API key

MFA Requirement

Not required

POST

chain.deposit.v1.DepositAddressService/ListDepositAddresses

Request

Testnet

curl --request POST \ \
  --url 'https://api.testnet.polyester.com/chain.deposit.v1.DepositAddressService/ListDepositAddresses' \
  --header 'Content-Type: application/json' \
  --header 'Connect-Protocol-Version: 1' \
  --data '{
  "chainId": 1,
  "subaccountId": "6789012345678"
}'

Responses

{
  "depositAddresses": [
    {
      "chainId": 1,
      "depositAddress": "0x7777777777777777777777777777777777777777"
    }
  ]
}

Request

chain.deposit.v1.ListDepositAddressesRequest

Response

chain.deposit.v1.ListDepositAddressesResponse

subaccountId string (fixed64) > 0

Optional public subaccount ID. When omitted, subaccount-scoped API keys use their bound subaccount; other callers use their authenticated root account.

chainId integer (int32) > 0

Optional PolyChain-registered source chain id filter. When omitted, the response returns the known deposit addresses for the selected target on chains that currently accept deposits, ordered by ascending chain id. A chain whose deposits are unavailable returns FailedPrecondition.

2 fields

Possible errors: 5

Key	HTTP status	Connect code	Error	When
unauthenticated	401	unauthenticated	Unauthenticated	Authentication required.
permission-denied	403	permission_denied	Permission Denied	Permission denied.
invalid-argument	400	invalid_argument	Invalid Argument	Invalid argument.
not-found	404	not_found	Not Found	Not found.
unavailable	503	unavailable	Unavailable	Service unavailable.