Embedded Widgets
Integrate Guavy's cryptocurrency data and trading functionality directly into your application with our ready-to-use web components. Built with modern standards, our widgets work seamlessly across all major frameworks and can be customized to match your brand.
What are Embedded Widgets?
Guavy's embedded widgets are standard web components that provide ready-to-use crypto market data and functionality for your application. Whether you need real-time price tickers, sentiment indicators, news feeds, or trading simulators, our widgets can be embedded in minutes with just a few lines of code.
Built on web component standards, our widgets work seamlessly with any modern web framework or vanilla JavaScript, making integration straightforward regardless of your tech stack.
Universal Framework Support
Our web components work with all modern frontend frameworks and rendering strategies:
- React - Compatible with React 16+ and Next.js
- Vue - Works with Vue 2, Vue 3, and Nuxt
- Svelte - Full support for Svelte and SvelteKit
- Server-Side Rendering (SSR) - Compatible with SSR environments
- Vanilla JavaScript - No framework required
Simply import the widget script and use the custom HTML element in your templates - no complex setup or build configuration needed.
Style Customization
Every Guavy widget is designed to blend seamlessly with your application's design system. Customize colors, typography, spacing, and layout to match your brand identity:
- Override default styles with CSS custom properties
- Apply your own CSS classes for complete control
- Support for both light and dark themes
- Responsive designs that adapt to any screen size
- Accessible components that meet WCAG standards
Our widgets expose well-documented CSS variables and styling APIs, giving you full control over the visual presentation while maintaining functionality.
Available Standard Widgets
Our standard widget library includes components for common cryptocurrency application needs:
- Price Ticker - Live cryptocurrency prices with percentage changes
- News Feed - Real-time cryptocurrency news and analysis
- Sentiment Indicator - Market sentiment visualization based on news and social trends
- Trade Simulator - Interactive paper trading interface
- Portfolio Display - Show portfolio holdings and performance
Each widget is optimized for performance, with lazy loading and efficient data updates to minimize impact on your application's performance.
Custom Widget Development
Need something beyond our standard widget library? We build custom web components tailored to your specific requirements. Our team works with you to create widgets that deliver exactly the functionality and user experience your application needs.
Custom widgets can integrate any combination of Guavy API features, from advanced charting and technical indicators to specialized trading interfaces and portfolio analytics. We handle the entire development process, delivering production-ready components that match your design specifications.
💡 Need custom widgets?
Contact our team to discuss your requirements. We'll design and build custom web components that integrate perfectly with your application and brand.
Getting Started
Ready to embed Guavy widgets in your application? Here's how to get started:
- Choose your widgets - Browse our widget documentation to find components that fit your needs
- Get your API key - Sign up for a Guavy account to receive your authentication credentials
- Install the widget library - Add our widget script to your application via npm or CDN
- Customize and deploy - Style the widgets to match your brand and deploy to production
Need help?
Our team is here to help you integrate Guavy widgets into your application. Contact us for technical support and widget documentation.
API Limits
The Guavy API has a limit of 10 simultaneous connections. You'll receive a 429 error if you reach the limit. At exceptionally high volumes, you may receive an HTTP 429 or 403 without a JSON body.
We recommend that you cache frequently accessed values that do not change often in your application's data store. This will prevent your application from bumping up against the throttling limitations and will likely provide faster access to that data.
Account Limits
Your Guavy account will typically have a licensed limit of at least 100,000 API calls per month. In addition, there is a limit of 10,000 API calls per day. If you reach these limits, you will receive a 429 error.
Connection Timeouts
The Guavy API has a 120-second timeout on API calls. You may see this type of timeout after you've made a network socket connection and are already sending and receiving data. Response times are dependent on the complexity of your request and the general load across Guavy. Some endpoints in the Guavy API return values that are large and slow to calculate.
