For Developers

Quick Start

// Fetch current Bitcoin fees
async function getCurrentFees() {
  const response = await fetch('https://api.celere.xyz/fees/current');
  const data = await response.json();
  
  console.log('Fastest fee:', data.mempool_based.fastest);
  return data;
}

// Get 6-hour prediction
async function getPrediction(hours = 6) {
  const response = await fetch(
    `https://api.celere.xyz/fees/predict?hours_ahead=${hours}`
  );
  const prediction = await response.json();
  
  console.log('Predicted fee:', prediction.predicted_fee_satvb);
  return prediction;
}

// Find optimal transaction time
async function findOptimalTime() {
  const predictions = [];
  
  for (let hour = 1; hour <= 24; hour++) {
    const pred = await fetch(
      `https://api.celere.xyz/fees/predict?hours_ahead=${hour}`
    );
    predictions.push(await pred.json());
  }
  
  const optimal = predictions.reduce((min, curr) => 
    curr.predicted_fee_satvb < min.predicted_fee_satvb ? curr : min
  );
  
  console.log(`Best time: +${optimal.hours_ahead}h at ${optimal.predicted_fee_satvb} sat/vB`);
  return optimal;
}