Get realtime wallet notifications for your Portal clients.
"Configuration"
> "Webhooks"
in the Portal Admin Dashboard and under the "Alert Webhooks"
section, click "New +"
.EVM Wallet Transactions
).EVM Wallet Transactions
EVM Wallet Transactions
selected as an event, Portal starts to listen for any inbound/outbound EIP-155 transactions for your clients that have an EIP-155 address. From then on when you create a new client with an EIP-155 address, Portal will notify you of their on-chain transactions.
When an EVM transaction occurs, Portal makes a POST
request to your configured alert webhook URL with a request body that contains the alert webhook event’s details. You will receive 2 alerts per transaction — The first alert is unconfirmed
and, once the transaction receives sufficient confirmations, the second alert is confirmed
.
EVM Wallet Transactions
currently sends alerts with the following use cases:ETH
) from another addressETH
) to another addressUSDC
) from another addressUSDC
) to another addressunconfirmed
alert without a subsequent confirmed
alert for the same transaction if this happens.2XX
status code, Portal will attempt to retry the request in intervals (1 minute, 10 minutes, 1 hour, 2 hours, 6 hours, 12 hours, and at 24 hours). If no successful response occurs during that timeframe, the webhook event will be dropped and you will need to manually replay the event.EVM Wallet Transactions
alerts.
Name | Chain ID | Blocks until confirmed |
---|---|---|
Ethereum | eip155:1 | 12 |
Ethereum Sepolia | eip155:11155111 | 18 |
Polygon | eip155:137 | 100 |
Polygon Amoy | eip155:80002 | 100 |
Arbitrum | eip155:42161 | 18 |
Arbitrum Sepolia | eip155:421614 | 600 |
Optimism | eip155:10 | 500 |
Optimism Sepolia | eip155:11155420 | 600 |
Base | eip155:8453 | 100 |
Base Sepolia | eip155:84532 | 100 |
Name | Type | Description |
---|---|---|
Content-Type | String | application/json |
X-WEBHOOK-SECRET | String | You can find the alert webhook secret in the Portal Admin Dashboard on the "Settings" page under the "Alert Webhooks" section. |
Solana Wallet Transactions
Solana Wallet Transactions
as the event, Portal begins monitoring transfer transactions for your Portal clients with a Solana address. Any new client created with a Solana address will also trigger notifications for their on-chain transfers.
When a Solana transfer transaction occurs, Portal makes a POST
request to your configured alert webhook URL with a request body that contains the alert webhook event’s details. You will receive 1 alert when the transaction is confirmed
.
Solana Wallet Transactions
currently sends alerts with the following use cases:SOL
) from another addressSOL
) to another addressUSDC
) from another addressUSDC
) to another address2XX
status code, Portal will attempt to retry the request once per minute for 3 minutes. If no successful response occurs during that timeframe, the webhook event will be dropped.Name | Type | Description |
---|---|---|
Content-Type | String | application/json |
X-WEBHOOK-SECRET | String | You can find the alert webhook secret in the Portal Admin Dashboard on the "Settings" page under the "Alert Webhooks" section. |
Signature Approvals
Signature Approvals
, Portal will make a request to your configured alert webhook URL any time that one of your Portal wallets attempt to sign. This request will contain the chainId
, clientId
, and signingRequest
, which you can use to derive if the signing request should be allowed to continue.
You must respond with a status code of 200-299
for the signing request to continue. To deny the request, you must respond with a 400
status code. If any other status code is received, or if 30 seconds passes with no response from your API, we will deny the signing request.
Signature Approval
alerts, your Portal clients’ signing requests will be denied to ensure Portal only continues processing the signing request when your API gives explicit permission to do so.Name | Type | Description |
---|---|---|
Content-Type | String | application/json |
X-WEBHOOK-SECRET | String | You can find the alert webhook secret in the Portal Admin Dashboard on the "Settings" page under the "Alert Webhooks" section. |
HTTPS
.X-WEBHOOK-SECRET
header value. You can find the secret for your alert webhook in the Portal Admin Dashboard.35.203.150.117
, 104.155.171.139
or 35.185.20.23
.2xx
status codes, Portal will retry sending the alert webhook event.
2xx
status code. (We only wait up to 10 seconds to receive a response before considering the alert webhook event’s delivery as failed
.)