Sector members
This endpoint returns a comprehensive collection of all Guavy Index sectors, each containing detailed information about its thematic details and member cryptocurrencies.
Guavy Index sectors are curated collections of cryptocurrencies organized by shared characteristics, use cases, or market sectors. Each sector represents a specific segment of the crypto ecosystem, enabling users to track sector performance across different crypto market segments, understand cryptocurrency categorization for investment diversification, and analyze trends across specific crypto themes and sectors.
The response includes 9 distinct objects covering major crypto sectors:
- Store of Value (SOV) - Digital assets serving as value preservation mechanisms
- Smart Contracts - Platforms enabling programmable blockchain applications
- DeFi - Decentralized finance protocols for lending, borrowing, and financial services
- Transactions - Cryptocurrencies optimized for payment and transfer use cases
- Memecoins - Community-driven, meme-based cryptocurrencies
- Oracle Integration - Tokens providing real-world data feeds to blockchain networks
- Exchange Utility - Cryptocurrencies with exchange, wallet, and trading platform utility
- Privacy - Privacy-focused cryptocurrencies with enhanced anonymity features
- AI Infrastructure - Tokens associated with artificial intelligence and machine learning infrastructure
Each sector includes a unique id, descriptive name, and complete list of member cryptocurrency symbols for easy integration and analysis.
Example request with authentication
The example below demonstrates how to make an authenticated API request using cURL. All Guavy API endpoints require authentication via a Bearer token, which should be included in the Authorization header. This token identifies your account and determines your access level to various endpoints.
To use this example:
- Replace
YOUR-GUAVY-ACCESS-TOKENwith your personal API key from the Guavy dashboard - The URL includes the specific endpoint path shown in the documentation
- All requests use HTTPS for secure data transmission
curl --request GET \
--url 'https://api.guavy.com/api/v3/index/list-all' \
--header 'Authorization: Bearer YOUR-GUAVY-ACCESS-TOKEN' \
--header 'Content-Type: application/json'
This request format works across all modern HTTP clients, including Python requests, JavaScript fetch, and other programming language libraries.
API Playground
Test this API route directly in your browser using our interactive Swagger documentation. Simply authenticate with your API key, input parameters, and execute requests to see real-time responses and understand how each endpoint behaves.
HTTP server response
The Guavy API uses standard HTTP response codes and JSON formatting for all responses. This consistent structure allows for predictable parsing and error handling in your applications.
Response Structure
All responses from the API are delivered as JSON objects with the following characteristics:
- HTTP status codes indicate the result category (2xx for success, 4xx for client errors, 5xx for server errors)
- Content is always delivered with the
application/jsonMIME type - Successful responses wrap data in a
Successobject - Error responses include descriptive messages to help troubleshoot issues
A successful response will look like this:
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 30
{
"Success": {
// Response payload containing requested data
}
}
For large responses, consider implementing pagination
using the limit and skip parameters where available to improve
performance.
API response format
The Guavy API generally follows REST conventions, with some deviations.
- All responses are wrapped in a top-level object.
- Responses return either `Success` or `Error`.
- Errors include a message field with details about the error.
- All responses use the generic JSON content type.
An example of a successful response from this API endpoint is shown below:
{
"Success":
{
"store_of_value" : object
"defi" : object
"smart_contracts" : object
"transactions" : object
"memecoins" : object
"oracle_integration" : object
"exchange_utility" : object
"privacy" : object
"ai_infrastructure" : object
}
}
Response data types
The table below details all data fields returned by this endpoint, including their types and descriptions. Understanding these fields is essential for properly integrating this API into your application and extracting meaningful data from responses.
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 100,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.