Webhooks

Tholos processes blockchain activity via webhooks from chain monitoring services. When on-chain activity is detected for your vault wallets, transactions are automatically ingested and reflected in your vault’s transaction history.

How it works

Tholos monitors your vault wallet addresses across all supported blockchains. When an incoming transaction is detected:

1. The chain monitoring service sends a webhook to Tholos
2. Tholos validates the webhook signature
3. The transaction is processed, matched to the relevant wallet, and stored
4. Vault balances are updated
5. Push notifications are sent to vault members (if configured)

This happens automatically — you don’t need to set up or configure webhooks yourself.

Supported activity types

Tholos detects and processes:

• Native token transfers (ETH, SOL, BTC, etc.)
• ERC-20/SPL token transfers
• Internal transactions (EVM contract-to-contract transfers)
• NFT transfers

Checking for new transactions

You can poll for transactions on a vault or rely on the automatic ingestion:

# Get recent transactions for a vault
curl https://api.tholos.app/vault/{vaultId}/transactions \
  -H "Authorization: Bearer $THOLOS_API_TOKEN"

Transactions include a displayType field that categorizes the activity:

Display type	Description
SENT	Outgoing transfer from your vault
RECEIVED	Incoming transfer to your vault
TRADED	Swap or trade
BOUGHT	Token purchase
SOLD	Token sale
MINTED	Token/NFT mint
CONTRACT_INTERACTION	Smart contract call
MESSAGE	Signed message
UNKNOWN	Unclassified activity

Spam filtering

Tholos automatically filters low-value token transfers (below $0.005 USD equivalent) to reduce noise from spam tokens. Filtered transactions are hidden by default but can be toggled:

# Show/hide a transaction (toggle spam status)
curl -X PATCH https://api.tholos.app/transaction/{txId}/visibility \
  -H "Authorization: Bearer $THOLOS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"visible": true}'

Reprocessing transactions

If you believe a transaction was missed or needs to be re-evaluated:

# Reprocess incoming transactions for a vault
curl -X POST https://api.tholos.app/vault/{vaultId}/reprocess-incoming-transactions \
  -H "Authorization: Bearer $THOLOS_API_TOKEN"

Note

Outbound webhooks (notifying your systems when events happen in Tholos) are not yet available via the public API. If you need real-time event delivery to your systems, contact the Tholos team.

Real-time updates

For the Tholos Dashboard and mobile app, real-time updates are delivered via Server-Sent Events (SSE). The SSE endpoint is internal and not available for direct API consumption.

For programmatic integrations, polling the transaction list endpoint is the recommended approach.

Next steps

• Transactions concept — understand the transaction lifecycle
• API Reference — see all transaction and vault endpoints