JavaScript

JavaScript SDK

Learn how to connect to Reverix's API using JavaScript.

Installation

First, install the required dependencies using npm or yarn:

npm install axios

Basic Setup

Create a new API client with your credentials:

import axios from 'axios'; const client = axios.create({ baseURL: 'https://api.reverix.ai/v1', headers: { 'Authorization': 'Bearer YOUR_SECRET_KEY', 'Content-Type': 'application/json', } });

Example: Get Token Price

Here's how to fetch the price of a token using its contract address:

async function getTokenPrice(contractAddress, networkId = 1) { try { const response = await client.get('/blockchain/token/price', { params: { address: contractAddress, network: networkId } }); return response.data; } catch (error) { console.error('Error fetching token price:', error); throw error; } } // Example usage const usdcAddress = '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'; const price = await getTokenPrice(usdcAddress); console.log('USDC Price:', price);

Error Handling

The API uses standard HTTP response codes and includes rate limiting (5 requests/second/key).

client.interceptors.response.use( response => response, error => { if (error.response) { switch (error.response.status) { case 401: console.error('Invalid API key'); break; case 429: console.error('Rate limit exceeded (5 req/sec)'); // Implement exponential backoff const retryAfter = error.response.headers['retry-after'] || 1; await new Promise(resolve => setTimeout(resolve, retryAfter * 1000)); return client.request(error.config); case 500: console.error('Server error'); break; default: console.error('API error:', error.response.data); } } return Promise.reject(error); } );

Rate Limit Handling

Here's an example of how to handle rate limits with exponential backoff:

async function makeRequestWithRetry(fn, maxRetries = 3) { let retries = 0; while (retries < maxRetries) { try { return await fn(); } catch (error) { if (error.response?.status === 429) { retries++; const delay = Math.min(1000 * Math.pow(2, retries), 10000); await new Promise(resolve => setTimeout(resolve, delay)); continue; } throw error; } } throw new Error('Max retries exceeded'); }

TypeScript Support

For TypeScript users, here are the type definitions for the token price response:

interface TokenPriceResponse { price: string; timestamp: number; network: number; address: string; symbol: string; decimals: number; } async function getTokenPrice( contractAddress: string, networkId: number = 1 ): Promise<TokenPriceResponse> { // ... implementation }