Webhooks
Receive real-time notifications when specific events occur in your Guavy integration. Our webhook system allows you to build responsive applications that react instantly to cryptocurrency trend changes, Guavy simulator trade executions, and critical newsroom events.
What are Webhooks?
Webhooks are HTTP callbacks that send real-time data to your server when a specific event occurs in the Guavy system. Instead of continuously polling our API for updates, webhooks push information directly to your application the moment something happens.
This event-driven approach reduces latency, minimizes unnecessary API calls, and ensures your application stays synchronized with the latest cryptocurrency data without any delay.
Custom Webhook Solutions
At Guavy, we understand that every integration has unique requirements. That's why we offer custom webhook solutions tailored to your specific needs. Our team works closely with you to design and implement webhooks that deliver exactly the data you need, when you need it.
💡 Need webhooks?
Contact our team to discuss your requirements. We'll help you design a webhook strategy that fits seamlessly into your application architecture.
Available Webhook Events
We can configure webhooks for a variety of events, including but not limited to:
- News Updates - Receive notifications when any news article is published that matches your specified criteria
- Trade Simulator Events - Get notified about executed trades, order status changes, or portfolio updates in the Guavy trade simulator
- Sentiment Analysis - Stay informed about significant shifts in market sentiment based on our analysis of news and social media trends
- Custom Events - Work with our team to create webhooks for your specific use case and business logic
Security & Reliability
Our webhook implementation includes industry-standard security features to ensure your data remains protected:
- HTTPS-only delivery for encrypted data transmission
- Request signature verification to authenticate webhook sources
- Automatic retry logic with exponential backoff for failed deliveries
- Configurable timeout and rate limiting options
Getting Started
Ready to integrate webhooks into your application? Here's how to get started:
- Contact our team - Reach out to discuss your webhook requirements and use cases
- Design your solution - Work with our engineers to define event types, payload structures, and delivery requirements
- Implement your endpoint - Build a webhook receiver endpoint in your application to process incoming events
- Test and deploy - Verify webhook delivery in our sandbox environment before going live
Need help?
Our team is here to guide you through the entire webhook integration process. Contact us to get started.
Token Costs
Each API call consumes tokens from your monthly budget. Endpoints that return richer or deeper data cost more tokens. Historical endpoints scale with the amount of data requested.
| Endpoint | Token Cost |
|---|---|
| GET /api/v1/ping | 1 |
| GET /api/v1/instruments/list-symbols | 1 |
| GET /api/v1/instruments/search-instruments/:query | 2 |
| GET /api/v1/instruments/get-detail/:symbol | 5 |
| GET /api/v1/instruments/scorecard/:symbol | 10 |
| GET /api/v1/newsroom/get-market-summary | 3 |
| GET /api/v1/newsroom/get-article/:id | 3 |
| GET /api/v1/newsroom/get-recent-briefs/:symbol | 3 – 8 (scales with limit) |
| GET /api/v1/newsroom/search-briefs/:symbol | 3 – 8 (scales with limit) |
| GET /api/v1/newsroom/get-instrument-analysis/:symbol | 10 |
| GET /api/v1/trades/get-recent-buys | 3 |
| GET /api/v1/trades/get-recent-sells | 3 |
| GET /api/v1/trades/get-recommendations | 5 |
| GET /api/v1/trades/get-current-action/:symbol/:strategy | 5 |
| GET /api/v1/trades/get-trend-history/:symbol/:limit | 5 – 15 (scales with limit) |
| GET /api/v1/trades/get-backtest-history/:symbol/:strategy | 8 – 20 (scales with years) |
| GET /api/v1/trades/get-backtest-summary/:symbol/:strategy | 8 – 20 (scales with years) |
| GET /api/v1/sentiment/get-sentiment-history/:symbol | 3 – 12 (scales with limit) |
| GET /api/v1/technical-analysis/get-price-history/:symbol | 5 |
| GET /api/v1/technical-analysis/get-indicators/:symbol | 8 |
Account Limits
Each plan includes a monthly token budget: 3,000 for Sandbox, 250,000 for Quant, and 2,000,000 for Commercial. You can top up at any time with a one-time token pack — unused tokens roll over every month. If you exceed your budget, the API returns a 403 until the next reset or until you purchase more tokens.
Connection Limits
The Guavy API has a limit of 10 simultaneous connections and a 120-second timeout per request. We recommend caching responses that don't change frequently to reduce token consumption and improve performance.
