Examples

import axios from 'axios';

const API_URL = 'https://pro.circular.fi/v2/lookups';
const API_KEY = 'your-api-key'; // Replace with your key

const params = {
  addresses: [
    'So11111111111111111111111111111111111111112',
    'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    'LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo',
    '675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8',
    'CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C'
  ]
};

async function getOptimalLookups() {
  try {
    const res = await axios.get(API_URL, {
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': API_KEY
      },
      params
    });

    console.log('Optimal Lookups:', res.data);
  } catch (e) {
    console.error('Error:', e?.response?.data || e.message);
  }
}

getOptimalLookups();

import axios, { AxiosResponse } from 'axios';

const API_URL = 'https://pro.circular.fi/v2/lookups';
const API_KEY = 'your-api-key'; // Replace with your key

interface OptimalLookupsParams {
  addresses: string[];
}

// Tu peux affiner ce type si tu veux documenter la réponse plus précisément
type OptimalLookupsResponse = unknown;

const params: OptimalLookupsParams = {
  addresses: [
    'So11111111111111111111111111111111111111112',
    'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    'LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo',
    '675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8',
    'CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C'
  ]
};

export async function getOptimalLookups(): Promise<OptimalLookupsResponse> {
  try {
    const res: AxiosResponse<OptimalLookupsResponse> = await axios.get(
      API_URL,
      {
        headers: {
          'Content-Type': 'application/json',
          'x-api-key': API_KEY
        },
        params
      }
    );

    console.log('Optimal Lookups:', res.data);
    return res.data;
  } catch (e: any) {
    throw new Error(e?.response?.data || e.message);
  }
}

import requests
from typing import List, Dict, Any

API_URL = "https://pro.circular.fi/v2/lookups"
API_KEY = "your-api-key"  # Replace with your key


def get_optimal_lookups(addresses: List[str]) -> Dict[str, Any]:
    """
    Fetch optimal lookups for a list of addresses.

    :param addresses: List of Solana addresses
    :return: API response as a dictionary
    """
    params = [("addresses", address) for address in addresses]

    headers = {
        "Content-Type": "application/json",
        "x-api-key": API_KEY
    }

    try:
        response = requests.get(
            API_URL,
            headers=headers,
            params=params,
            timeout=30
        )
        response.raise_for_status()
        return response.json()

    except requests.exceptions.RequestException as e:
        raise RuntimeError(
            f"Optimal lookups request failed: "
            f"{getattr(e.response, 'text', str(e))}"
        )


if __name__ == "__main__":
    result = get_optimal_lookups([
        "So11111111111111111111111111111111111111112",
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo",
        "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C"
    ])

    print("Optimal Lookups:", result)

use reqwest::Client;
use serde_json::Value;
use std::error::Error;

const API_URL: &str = "https://pro.circular.fi/v2/lookups";
const API_KEY: &str = "your-api-key"; // Replace with your key

pub async fn get_optimal_lookups(
    addresses: Vec<&str>,
) -> Result<Value, Box<dyn Error>> {
    let client = Client::new();

    // Build query params: addresses=...&addresses=...
    let params: Vec<(&str, &str)> = addresses
        .iter()
        .map(|addr| ("addresses", *addr))
        .collect();

    let response = client
        .get(API_URL)
        .query(&params)
        .header("Content-Type", "application/json")
        .header("x-api-key", API_KEY)
        .send()
        .await?
        .error_for_status()? // Converts HTTP errors into Rust errors
        .json::<Value>()
        .await?;

    Ok(response)
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let addresses = vec![
        "So11111111111111111111111111111111111111112",
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo",
        "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C",
    ];

    let result = get_optimal_lookups(addresses).await?;
    println!("Optimal Lookups: {}", result);

    Ok(())
}

PreviousEndpoint NextTokens

Last updated 1 month ago