> For the complete documentation index, see [llms.txt](https://docs.heyhal.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.heyhal.xyz/api-documentation/get-sol-price.md).
# Get SOL Price
**Endpoint:** `GET /api/v1/coin/sol-price`
### Description
This endpoint retrieves the current price of SOL in USD from CoinGecko's API. The response is cached for 60 seconds to minimize API calls and improve performance.
### Authentication
Required: No
Type: None
### Request
#### Headers
#### Content-Type: application/json
No parameters required.
### Response
#### Success Response
Status Code: 200 OK
Content-Type: application/json
interface SolPriceResponse {
price: number; // SOL price in USD
}
Example Response:
{
"price": 102.45
}
#### Error Response
Status Code: 500 Internal Server Error
{
"error": "An internal error occurred. Please try again later."
}
### Example Usage
### // Basic fetch
### async function getSOLPrice() {
### try {
### const response = await fetch('');
###
### if (!response.ok) {
### throw new Error(\`HTTP error! status: ${response.status}\`);
### }
###
### const { price } = await response.json();
### return price;
### } catch (error) {
### console.error('Error fetching SOL price:', error);
### throw error;
### }
### }
### // With client-side caching
### class SOLPriceManager {
### private cache: {
### price: number;
### timestamp: number;
### } | null = null;
###
### private readonly CACHE\_DURATION = 60000; // 60 seconds
###
### async getPrice(): Promise\ {
### // Check cache
### if (this.cache &&
### Date.now() - this.cache.timestamp < this.CACHE\_DURATION) {
### return this.cache.price;
### }
###
### // Fetch new price
### const response = await fetch('');
### const { price } = await response.json();
###
### // Update cache
### this.cache = {
### price,
### timestamp: Date.now()
### };
###
### return price;
### }
###
### clearCache() {
### this.cache = null;
### }
### }
### Implementation Notes
1\. Caching
The endpoint uses server-side caching with a 60-second expiration
If CoinGecko API fails, returns 0 as a fallback value
Cache is automatically invalidated after expiration
Error Handling
// Example of robust error handling
async function getSOLPriceWithRetry(
maxRetries = 3,
retryDelay = 1000
): Promise\ {
let attempts = 0;
while (attempts < maxRetries) {
try {
const response = await fetch(
''
);
if (!response.ok) {
throw new Error(\`HTTP error! status: ${response.status}\`);
}
const { price } = await response.json();
if (typeof price !== 'number' || isNaN(price)) {
throw new Error('Invalid price received');
}
return price;
} catch (error) {
attempts++;
if (attempts === maxRetries) {
throw error;
}
await new Promise(resolve =>
setTimeout(resolve, retryDelay \* attempts)
);
}
}
throw new Error('Failed to fetch SOL price');
}
3\. Price Monitoring
class SOLPriceMonitor {
private price: number = 0;
private listeners: ((price: number) => void)\[] = \[];
private intervalId: NodeJS.Timeout | null = null;
constructor(private pollInterval: number = 60000) {}
addListener(callback: (price: number) => void) {
this.listeners.push(callback);
}
async start() {
await this.updatePrice();
this.intervalId = setInterval(
() => this.updatePrice(),
this.pollInterval
);
}
stop() {
if (this.intervalId) {
clearInterval(this.intervalId);
this.intervalId = null;
}
}
private async updatePrice() {
try {
const response = await fetch(
''
);
const { price } = await response.json();
if (price !== this.price) {
this.price = price;
this.notifyListeners();
}
} catch (error) {
console.error('Error updating SOL price:', error);
}
}
private notifyListeners() {
this.listeners.forEach(listener => listener(this.price));
}
}
### Best Practices
1\. Price Display
function formatSOLPrice(price: number): string {
return new Intl.NumberFormat('en-US', {
style: 'currency',
currency: 'USD',
minimumFractionDigits: 2,
maximumFractionDigits: 2
}).format(price);
}
Price Change Tracking
interface PricePoint {
price: number;
timestamp: number;
}
class PriceTracker {
private history: PricePoint\[] = \[];
private readonly MAX\_HISTORY = 100;
addPrice(price: number) {
this.history.push({
price,
timestamp: Date.now()
});
if (this.history.length > this.MAX\_HISTORY) {
this.history.shift();
}
}
getPercentageChange(timeframeMs: number): number {
const now = Date.now();
const compareTime = now - timeframeMs;
const oldPrice = this.history.find(
point => point.timestamp <= compareTime
);
if (!oldPrice) return 0;
const currentPrice = this.history\[this.history.length - 1].price;
return ((currentPrice - oldPrice.price) / oldPrice.price) \* 100;
}
}
Price Alert System
Ask
Copy
Apply to kingOfTheHil...
interface PriceAlert {
threshold: number;
isAbove: boolean;
callback: (price: number) => void;
}
class SOLPriceAlerts {
private alerts: PriceAlert\[] = \[];
private currentPrice: number = 0;
addAlert(alert: PriceAlert) {
this.alerts.push(alert);
this.checkAlert(alert);
}
updatePrice(newPrice: number) {
this.currentPrice = newPrice;
this.checkAlerts();
}
private checkAlerts() {
this.alerts.forEach(alert => this.checkAlert(alert));
}
private checkAlert(alert: PriceAlert) {
const triggered = alert.isAbove
? this.currentPrice > alert.threshold
: this.currentPrice < alert.threshold;
if (triggered) {
alert.callback(this.currentPrice);
}
}
}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.heyhal.xyz/api-documentation/get-sol-price.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.