Platform Overview

Chirpify transforms TradingView alerts into intelligent, filtered notifications that help you make better trading decisions. Perfect for traders using private indicators who want to reduce noise and improve signal quality without modifying code.

Key Concepts

Account Setup

Get started with Chirpify in just a few minutes.

Creating Your Account

1. Visit app.chirpify.dev/signup
2. Enter your email address and create a secure password
3. Verify your email address by clicking the link sent to your inbox
4. Complete the onboarding flow to set up your first alert group

Plan Selection

Choose the plan that fits your trading needs:

Authentication

Chirpify uses secure authentication to protect your trading data and configurations.

Sign-In Methods

• Email/Password: Traditional authentication with your email and password
• Google OAuth: Sign in with your Google account for faster access

Security Features

• All data encrypted in transit and at rest
• Session timeouts for inactive accounts
• Secure API key management for exchange connections
• No storage of withdrawal permissions

Telegram Bot Setup

Connect Chirpify to Telegram to receive filtered alerts directly in your chat.

Step-by-Step Setup

1. Start a chat with BotFather

   Open Telegram and search for @BotFather or click here

2. Create your bot

   Send /newbot to BotFather and follow the prompts:

   /newbot
   Choose a name for your bot: My Trading Alerts
   Choose a username for your bot: mytradingalerts_bot

3. Get your bot token

   BotFather will provide a token like 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

   Important: Keep this token secure! Anyone with this token can control your bot.

4. Configure in Chirpify

   In your Chirpify dashboard:

   • Go to Channels → Add Channel → Telegram
   • Paste your bot token
   • Click "Test Connection" to verify

Telegram Bot Configuration

Finding Your Chat ID

To send messages to a specific chat, you need the Chat ID:

For Private Messages

1. Start a chat with your bot by searching for its username
2. Send any message to the bot (like /start)
3. In Chirpify, click "Get Chat ID" - it will show your personal chat ID

For Groups/Channels

1. Add your bot to the group/channel as an administrator
2. Send a message mentioning the bot (e.g., @yourbotname hello)
3. In Chirpify, click "Get Chat ID" to see available group IDs

Telegram Channels & Groups

Setting Up Channels

Telegram channels are perfect for broadcasting alerts to multiple subscribers:

1. Create a new channel in Telegram
2. Add your bot as an administrator with "Post Messages" permission
3. Configure the channel ID in Chirpify

Group Configuration

Groups allow interactive alerts and discussions:

• Create or join a Telegram group
• Add your bot with appropriate permissions
• Configure group privacy settings as needed

Message Formatting

Customize how your alerts appear in Telegram:

🚨 ALERT TRIGGERED 🚨
Symbol: {{symbol}}
Price: ${{price}}
Signal: {{action}}
Time: {{timestamp}}

Testing Telegram Delivery

Send Test Message

Verify your Telegram configuration by sending a test message:

1. Go to Channels in your Chirpify dashboard
2. Find your Telegram channel configuration
3. Click "Send Test Message"
4. Check your Telegram chat for the test message

Common Issues

General Exchange Setup

Connect Chirpify to crypto exchanges for automated trading based on your filtered alerts.

Security Best Practices

Required Permissions

For each exchange, ensure your API key has these permissions:

• ✅ Read account information (balances, positions)
• ✅ Create orders (market and limit orders)
• ✅ Cancel orders (modify existing orders)
• ❌ Withdraw funds (never enable this)

Testnet vs Mainnet

Start with testnet environments to verify your setup before live trading:

Bybit Integration

Creating API Keys

1. Log into your Bybit account
2. Go to API Management → Create New Key
3. Select permissions:
   • ✅ Account Info
   • ✅ Order
   • ✅ Position
   • ❌ Withdraw (never enable)
4. Add IP restrictions for security (optional but recommended)
5. Save your API Key and Secret securely

Configuration in Chirpify

1. Go to Channels → Add Channel → Bybit
2. Enter your API Key and Secret
3. Select environment (Testnet for testing, Mainnet for live trading)
4. Configure default order settings:
   • Order type (Market/Limit)
   • Position sizing method
   • Default quantity or percentage
5. Click "Test Connection" to verify

Order Configuration

Binance Integration

API Key Setup

1. Access Binance API Management in your account settings
2. Create a new API key with a descriptive name (e.g., "Chirpify Trading")
3. Configure permissions:
   • ✅ Enable Spot & Margin Trading
   • ✅ Enable Futures Trading (if needed)
   • ❌ Enable Withdrawals (never enable)
4. Set up IP access restriction for enhanced security
5. Note down your API Key and Secret Key

Binance-Specific Features

• Spot Trading: Trade spot markets with immediate settlement
• Futures Trading: Access to Binance Futures markets
• Advanced Order Types: Support for OCO and other advanced orders
• Sub-account Support: Trade with sub-account API keys

KuCoin Integration

Three-Part Authentication

KuCoin uses a three-part authentication system:

1. API Key: Your public identifier
2. Secret Key: Used for request signing
3. Passphrase: Additional security layer you create

Setup Process

1. Go to KuCoin API Management
2. Create a new API with these settings:
   • API Name: "Chirpify Trading Bot"
   • Passphrase: Create a strong passphrase (save this!)
   • Permissions: Trade only (no withdrawal)
3. Configure IP whitelist (recommended)
4. Save all three values: API Key, Secret Key, and Passphrase

Configuration in Chirpify

API Key: 5c2db93503aa674c74ed2e3a
Secret: f03a5284-5c39-4aaa-9b20-dea1014b86c6
Passphrase: YourSecurePassphrase123

Hyperliquid Integration

Wallet-Based Authentication

Hyperliquid uses wallet-based authentication instead of traditional API keys:

1. Create a Trading Wallet

   Set up a dedicated wallet for Chirpify trading:

   • Create a new wallet or use an existing one
   • Fund it with appropriate amounts for trading
   • Note the wallet address (starts with 0x...)

2. Export Private Key

   ⚠️ Critical Security Warning: Private keys provide full access to your wallet. Only use dedicated trading wallets with limited funds.

   • Export the private key from your wallet
   • Keep this extremely secure
   • Never share or expose this key

3. Configure in Chirpify

   • Go to Channels → Add Channel → Hyperliquid
   • Enter your wallet's private key
   • Select network (Testnet/Mainnet)
   • Test the connection

Hyperliquid Features

• Perpetual Futures: Trade perpetual contracts with high leverage
• Low Fees: Competitive trading fees
• Fast Execution: High-performance trading engine
• Advanced Orders: Support for sophisticated order types

Testing & Verification

Connection Testing

Always verify your exchange connections before live trading:

1. Test API Connection: Click "Test Connection" in channel settings
2. Verify Account Access: Check that balances load correctly
3. Small Test Order: Place a minimal test order
4. Monitor Execution: Confirm orders execute as expected

Portfolio Tracking

Monitor your connected exchange accounts:

• View real-time balances across all connected exchanges
• Track open positions and orders
• Monitor P&L and trading performance
• Review order history and execution logs

Order Verification

Creating Alert Groups

Alert groups are the core of Chirpify's filtering system. They define how incoming alerts are processed and when chirps are sent.

Basic Alert Group Setup

1. Create a New Group

   Go to Alert Groups → Create New Group

2. Choose Group Type

   • Simple Filter: Basic alert filtering with conditions
   • Logic Group: Complex AND/OR/NOT logic combinations
   • Sequence Group: Alerts that must occur in specific order

3. Configure Basic Settings

   • Group name and description
   • Target symbols/tickers
   • Delivery channels
   • Active time windows

Alert Group Components

Boolean Logic (AND/OR/NOT)

Create sophisticated filtering rules using boolean logic to combine multiple conditions.

Logic Operators

Complex Logic Examples

// Conservative entry strategy
(Momentum_Buy AND Volume_Spike) 
AND 
(NOT Overbought_RSI) 
AND 
(Market_Hours OR Crypto_24h)

// Confirmation from multiple indicators  
(Indicator_A_Buy OR Indicator_B_Buy)
AND
(Volume > 1.5x_Average)
AND
(NOT Recent_Alert_15min)

Building Logic Rules

1. Start with simple conditions
2. Use parentheses to group related conditions
3. Test with historical data when possible
4. Add time-based conditions to prevent spam
5. Include risk management filters

Nesting & Hierarchy

Create hierarchical alert structures where groups can depend on other groups.

Parent-Child Relationships

Dependency Rules

• Require Parent: Child only triggers if parent has triggered recently
• Block on Parent: Child won't trigger if parent has triggered
• Inherit Settings: Child uses parent's timing and rate limit settings
• Override Settings: Child has its own independent settings

Use Cases for Nesting

Value Conditions & Thresholds

Set specific conditions based on price, volume, and indicator values to fine-tune your filtering.

Price Conditions

Volume Conditions

// Volume-based filters
Volume > Average_Volume * 2.0    // High volume spike
Volume_Ratio > 1.5               // Above normal volume  
Dollar_Volume > $1M              // Minimum liquidity
Unusual_Volume_Spike = true      // Detected volume anomaly

Technical Indicator Conditions

Time-Based Conditions

• Market Hours: Only during regular trading hours
• Day of Week: Exclude weekends or specific days
• Time Windows: Active only during specified hours
• Session Filters: Pre-market, regular hours, after-hours

Sequence-Based Alerts

Create alerts that trigger only when events occur in a specific order within defined time windows.

Sequence Concepts

Sequence Examples

Sequence Configuration

Rate Limiting & Delivery Modes

Control the frequency and timing of your alerts to prevent notification fatigue and improve signal quality.

Rate Limiting Options

Delivery Modes

Silence Periods

Define when alerts should NOT be sent:

• Trading Hours: Only during market open
• Personal Schedule: Respect your sleep/work schedule
• Market Conditions: Pause during high volatility or low liquidity
• Temporary Disable: Vacation mode or maintenance windows

Alert Group: "High-Conviction Trades"
├── Rate Limits:
│   ├── Max 5 alerts per hour
│   ├── Min 30 minutes between same-symbol alerts  
│   └── Max 20 alerts per trading day
├── Delivery Mode: Smart (immediate for score > 8.0)
├── Silence Periods:
│   ├── Weekends (unless crypto)
│   ├── 11 PM - 6 AM (local time)
│   └── Major market holidays
└── Escalation: Email backup if Telegram fails

Setting Up TradingView Alerts

Connect your TradingView indicators to Chirpify using webhooks - works with any indicator, private or public.

TradingView Alert Creation

1. Open Your Chart

   Navigate to the chart with your indicator and desired symbol

2. Create Alert

   Click the alert icon in the top toolbar or press Alt+A

3. Configure Alert Condition

   • Select your indicator from the dropdown
   • Choose the specific condition (crossing, above/below value, etc.)
   • Set any required threshold values

4. Set Alert Actions

   • Enable "Webhook URL" option
   • Paste your Chirpify webhook URL
   • Configure the message format (see payload section)

Getting Your Webhook URL

1. Go to your Chirpify Alert Groups
2. Select or create an alert group
3. Copy the webhook URL from the group settings
4. Each alert group has a unique webhook URL

https://webhooks.chirpify.dev/alerts/abc123def456
                                
⚠️ Keep this URL private - anyone with it can send alerts to your group

Alert Frequency Settings

• Once Per Bar Close: Alert triggers only at candle close
• Once Per Bar: First trigger per candle, then waits for next bar
• All: Triggers every time condition is met (can cause spam)

Webhook Configuration

Configure your TradingView webhook settings to send properly formatted alerts to Chirpify.

Webhook URL Setup

Message Configuration

The message you configure in TradingView becomes the payload sent to Chirpify. Use these variables:

Security Considerations

Webhook Limits

Payload Format & Requirements

Structure your TradingView alert messages for optimal processing by Chirpify.

Recommended JSON Format

{
  "symbol": "{{ticker}}",
  "action": "BUY",
  "price": {{close}},
  "volume": {{volume}}, 
  "timestamp": "{{time}}",
  "timeframe": "{{interval}}",
  "strategy": "My Momentum Strategy",
  "confidence": 8.5,
  "stop_loss": 145.50,
  "take_profit": 155.75
}

Simple Text Format

For basic setups, you can use simple text messages:

SIGNAL: BUY {{ticker}} at {{close}} | Volume: {{volume}} | Time: {{time}}

Advanced Payload Examples

{
  "signal_type": "SCALP",
  "symbol": "{{ticker}}",
  "entry_price": {{close}},
  "direction": "LONG",
  "risk_reward": 1.5,
  "timeframe": "{{interval}}",
  "volume_spike": true,
  "rsi": 65.2
}

{
  "strategy": "SWING_MOMENTUM",
  "ticker": "{{ticker}}",
  "signal": "ENTRY",
  "price": {{close}},
  "target_1": 155.00,
  "target_2": 160.00,
  "stop_loss": 145.00,
  "position_size": "2%",
  "market_cap": "LARGE"
}

Required Fields

For optimal processing, include these minimum fields:

• Symbol: Asset identifier (ticker, pair)
• Action/Signal: What action to take (BUY, SELL, HOLD)
• Price: Current or trigger price
• Timestamp: When the signal occurred

Field Validation

Testing Webhook Delivery

Verify your TradingView webhook integration is working correctly before relying on it for live trading.

Testing Process

1. Create Test Alert

   Set up a simple alert that triggers frequently for testing:

   • Use a short timeframe (1 or 5 minutes)
   • Choose a simple condition (price crosses moving average)
   • Set to trigger "All" instead of "Once Per Bar"

2. Monitor Delivery

   Check multiple places for successful delivery:

   • Chirpify Alert Activity logs
   • Your configured delivery channels (Telegram, email)
   • Browser developer tools for webhook calls

3. Verify Payload

   Ensure the data arrives as expected:

   • All variables are properly substituted
   • JSON format is valid (if using JSON)
   • Required fields are present

Testing Tools

Common Test Scenarios

TradingView Troubleshooting

Resolve common issues with TradingView webhook integration.

Common Issues & Solutions

Debugging Steps

1. Check TradingView Alert Status

   Verify the alert is active and configured correctly

2. Monitor Network Traffic

   Use browser dev tools to see if webhook requests are being sent

3. Review Chirpify Logs

   Check the Activity section for incoming webhook requests

4. Test with Minimal Configuration

   Start with the simplest possible alert and gradually add complexity

5. Contact Support

   If issues persist, contact support with specific error messages and examples

Webhook Testing URLs

Use these tools to test webhook delivery independently:

• webhook.site: Temporary URLs for testing webhook delivery
• httpbin.org: Simple HTTP request inspector
• ngrok: Tunnel to local development server

Analytics & Monitoring

Track the performance and effectiveness of your alert filtering with comprehensive analytics.

Dashboard Overview

Alert Group Analytics

Detailed performance metrics for each alert group:

• Trigger Frequency: How often each group activates
• Filter Performance: Which conditions are most effective
• Delivery Success: Channel reliability and timing
• User Engagement: How often you act on different alert types

Custom Reports

Real-Time Monitoring

• Live Activity Feed: See alerts as they're processed
• System Health: Monitor API connections and delivery channels
• Alert Queue: Track processing delays and backlogs
• Error Tracking: Immediate notification of system issues

Plan Limits & Subscription Tiers

Understand the limits and features available with each Chirpify plan.

Plan Comparison

Usage Monitoring

Track your usage against plan limits:

• Daily Chirp Count: Monitor chirps sent vs. daily limit
• Alert Group Usage: See how many groups you're using
• Feature Access: Identify which features require plan upgrades
• Historical Usage: Review past usage patterns for plan optimization

Plan Upgrade Benefits

Troubleshooting Guide

Common issues and their solutions to keep your Chirpify system running smoothly.

Alert Processing Issues

Delivery Channel Problems

Performance Optimization

Getting Support