Amyth
AppMarketMarketplaceRanksLeaderboardDocs
Docs Home
OverviewSet Up a WalletGet USDC on SolanaYour First Vault
OverviewStrategy PresetsThe OptimizerDeposit & Withdraw
OverviewWire Your First AlertTroubleshooting
OverviewSubscribingBecoming a CreatorPublish Quality Gates
OverviewVault ArchitectureOnchain Risk RailsVerify a Vault
OverviewThe Master ChartNotifications & SharingLeaderboard
FAQ
Glossary
DocsWebhooks
Custom Execution

Webhooks

Every webhook vault gets four unique URLs, one per action. Anything that can send an HTTP request can trigger an onchain trade: TradingView alerts, AI agents, custom scripts, or any external signal source. Your vault executes, validates onchain, and settles on Jupiter Perps, all within seconds.

What can plug into webhooks?

📈TradingView Alerts

Wire any indicator or Pine Script strategy to onchain execution. Your chart signal fires, your vault trades.

🤖AI Agents

Give an AI agent your webhook URLs. It can trade on your behalf without ever having access to your funds. The agent sends signals; your vault enforces the risk rails.

⚙️Custom Scripts

A Python script, a Node.js bot, a cron job: anything that can POST to a URL can open and close positions through your vault.

🔗Third-Party Platforms

Any trading signal service, alert aggregator, or automation platform that supports webhook outputs can plug directly into your vault.

💡Why this matters for AI agents

The webhook model is uniquely powerful for AI agents: the agent gets the ability to trade, but never gets access to your funds. Your vault's onchain program validates every signal against your risk rails: max leverage, slippage caps, position size limits. Even a compromised or misbehaving agent can only submit trades within the bounds you set. It can never withdraw.

How the signal flow works

Signal Source→Amyth Webhook API→Onchain Validation→Jupiter Perps

The signal source doesn't matter: TradingView, an AI agent, a Python script, or a curl command. Amyth's webhook API receives the request, the onchain program validates it against your vault's risk rails, and the trade executes on Jupiter Perps. If validation fails (slippage too high, leverage exceeded, replay attempt), the trade reverts and nothing happens.

Four webhook endpoints per vault

Open Long

Opens a long position (betting price goes up)

Close Long

Closes an existing long position

Open Short

Opens a short position (betting price goes down)

Close Short

Closes an existing short position

Built-in reliability

5-retry engine: If the RPC is congested or a transaction fails, Amyth retries up to 5 times with exponential backoff.

Slippage cap: 2% default tolerance. If the execution price would be worse than 2% from the oracle price, the trade reverts.

Replay protection: Each signal includes a nonce. The onchain program rejects duplicates. No double-execution.

Manual override: A one-click test button on the vault panel lets you verify the pipeline without waiting for a signal.

Set Up Your Webhook Vault

Create a vault, copy the URLs, and wire them to your signal source.

Troubleshooting

Common issues and how to fix them.

Was this page helpful?
← PreviousDeposit & WithdrawNext →Wire Your First Alert