Guavy API

Guavy API Documentation

Sector members

get
/api/v3/index/list-all

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:

  1. Replace YOUR-GUAVY-ACCESS-TOKEN with your personal API key from the Guavy dashboard
  2. The URL includes the specific endpoint path shown in the documentation
  3. 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/json MIME type
  • Successful responses wrap data in a Success object
  • 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.

store_of_value
object
cyrptocurrencies that can behave as a store of value and unit of exchange
defi
object
coins that are associated with decentralized finance, lending, borrowing, and other financial services
smart_contracts
object
coins that are associated with smart contracts, and other programmable assets
transactions
object
cryptocurrencies involved in transactions and other transferable assets
memecoins
object
memecoins, volatile meme-based cryptocurrencies
oracle_integration
object
coins that are associated with oracle integration, and other data feeds
exchange_utility
object
cryptocurrencies with exchange utility, and other exchange-related services, including wallets and other services
privacy
object
cryptocurrencies built on privacy-focused protocols
ai_infrastructure
object
cryptocurrencies that are associated with ai infrastructure

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.

Was this helpful?