Automation API Reference

Send automated trading signals via HTTP POST requests. Integrate with TradingView, custom scripts, or any webhook-enabled platform.

Base URL

https://alerts.algobread.ai

Endpoints

HTTP Status Codes

Code	Status	Description
`200`	OK	Request processed successfully
`400`	Bad Request	Invalid request format or missing required fields
`401`	Unauthorized	Invalid or missing breadkey
`422`	Unprocessable Entity	Validation error - see response body for details
`500`	Internal Server Error	Server error - contact support if persistent

TradingView Integration

You can use dynamic TradingView variables in your webhook alerts to create intelligent, adaptive trading signals.

Example with TradingView Variables

JSON

{
  "acct_id": "TC123456789",
  "symbol": "{{ticker}}",
  "stance": "{{strategy.market_position}}",
  "qty": {{strategy.order.contracts}},
  "breadkey": "your_breadkey_here"
}

Note: TradingView will automatically replace these placeholders with actual values when the alert fires. The {{strategy.market_position}} variable returns long, short, or flat based on your strategy's current position.

Common Variables

Variable	Description
`{{ticker}}`	Current instrument symbol
`{{strategy.market_position}}`	Strategy position: long, short, or flat
`{{strategy.order.contracts}}`	Number of contracts to trade
`{{close}}`	Current close price

Best Practices

Always Test First

Use the /test endpoint to validate your payload before sending to production. This prevents errors and validates your webhook configuration.

Implement Error Handling

Always check the response status code and handle errors appropriately. Log failures and implement retry logic for network issues.

Monitor Your Alerts

Regularly check TradingView's alert log to ensure your webhooks are firing correctly. Set up notifications for failed alerts.

Secure Your Breadkeys

Never expose breadkeys in public repositories, screenshots, or share them with others. Rotate keys periodically and revoke unused ones.

Ready to Automate?

Get started with automated trading by creating your first breadkey and setting up a webhook alert.

Create Breadkey Build Alert

TradingView Indicators

Pine strategies optimized for automation

Connections

Connect your trading platforms

HTTP Status Codes

Code	Status	Description
`200`	OK	Request processed successfully
`400`	Bad Request	Invalid request format or missing required fields
`401`	Unauthorized	Invalid or missing breadkey
`422`	Unprocessable Entity	Validation error - see response body for details
`500`	Internal Server Error	Server error - contact support if persistent

TradingView Integration

You can use dynamic TradingView variables in your webhook alerts to create intelligent, adaptive trading signals.