POST /v1/quotes

curl -X POST https://api.nowramp.com/v1/quotes \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_abc123",
    "sourceCurrency": "USD",
    "targetCurrency": "USDC",
    "sourceAmount": "100.00",
    "network": "polygon"
  }'

{
  "success": true,
  "data": {
    "id": "quote_xyz789",
    "customerId": "cust_abc123",
    "sourceCurrency": "USD",
    "targetCurrency": "USDC",
    "sourceAmount": "100.00",
    "targetAmount": "96.50",
    "exchangeRate": "1.00",
    "network": "polygon",
    "fees": {
      "network": "0.50",
      "service": "3.00",
      "total": "3.50"
    },
    "expiresAt": "2024-01-15T10:31:00Z",
    "expiresInSeconds": 60,
    "isExpired": false,
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

GET /v1/quotes/{quoteId}

curl https://api.nowramp.com/v1/quotes/quote_xyz789 \
  -H "X-API-Key: your_api_key"

{
  "success": true,
  "data": {
    "id": "quote_xyz789",
    "customerId": "cust_abc123",
    "sourceCurrency": "USD",
    "targetCurrency": "BTC",
    "sourceAmount": "100.00",
    "targetAmount": "0.00234567",
    "exchangeRate": "42650.00",
    "network": "bitcoin",
    "fees": {
      "network": "0.50",
      "service": "2.50",
      "total": "3.00"
    },
    "status": "active",
    "expiresAt": "2024-01-15T10:31:00Z",
    "expiresInSeconds": 45,
    "isExpired": false,
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

// Fetch a quote
async function getQuote(customerId, amount) {
  const response = await fetch('https://api.nowramp.com/v1/quotes', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      customerId,
      sourceCurrency: 'USD',
      targetCurrency: 'ETH',
      sourceAmount: amount,
      network: 'ethereum'
    })
  });

  return response.json();
}

// Handle quote with expiry tracking
async function handleQuoteWithExpiry(customerId, amount) {
  const { data: quote } = await getQuote(customerId, amount);

  // Check if quote is already expired
  if (quote.isExpired) {
    console.log('Quote already expired, fetching new quote...');
    return handleQuoteWithExpiry(customerId, amount);
  }

  // Set up expiry warning (10 seconds before expiration)
  const warningTimeout = setTimeout(() => {
    console.log('Quote expiring soon! Refresh recommended.');
    onQuoteExpiringSoon(quote);
  }, (quote.expiresInSeconds - 10) * 1000);

  // Set up auto-refresh on expiry
  const expiryTimeout = setTimeout(() => {
    console.log('Quote expired, fetching new quote...');
    onQuoteExpired(quote);
  }, quote.expiresInSeconds * 1000);

  // Return quote with cleanup function
  return {
    quote,
    cleanup: () => {
      clearTimeout(warningTimeout);
      clearTimeout(expiryTimeout);
    }
  };
}

// Create order before quote expires
async function createOrderFromQuote(quoteId) {
  // First, verify quote is still valid
  const { data: quote } = await fetch(
    `https://api.nowramp.com/v1/quotes/${quoteId}`,
    { headers: { 'X-API-Key': 'your_api_key' } }
  ).then(r => r.json());

  if (quote.isExpired) {
    throw new Error('Quote has expired. Please request a new quote.');
  }

  // Proceed with order creation
  const response = await fetch('https://api.nowramp.com/v1/orders', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ quoteId })
  });

  return response.json();
}

import { useState, useEffect, useCallback } from 'react';

interface Quote {
  id: string;
  expiresAt: string;
  expiresInSeconds: number;
  isExpired: boolean;
  // ... other fields
}

function useQuoteWithExpiry(customerId: string, amount: string) {
  const [quote, setQuote] = useState<Quote | null>(null);
  const [secondsRemaining, setSecondsRemaining] = useState(0);
  const [isExpired, setIsExpired] = useState(false);

  const fetchQuote = useCallback(async () => {
    const response = await fetch('https://api.nowramp.com/v1/quotes', {
      method: 'POST',
      headers: {
        'X-API-Key': 'your_api_key',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        customerId,
        sourceCurrency: 'USD',
        targetCurrency: 'ETH',
        sourceAmount: amount
      })
    });

    const { data } = await response.json();
    setQuote(data);
    setSecondsRemaining(data.expiresInSeconds);
    setIsExpired(false);
  }, [customerId, amount]);

  // Countdown timer
  useEffect(() => {
    if (secondsRemaining <= 0) {
      setIsExpired(true);
      return;
    }

    const timer = setInterval(() => {
      setSecondsRemaining(prev => {
        if (prev <= 1) {
          setIsExpired(true);
          return 0;
        }
        return prev - 1;
      });
    }, 1000);

    return () => clearInterval(timer);
  }, [secondsRemaining]);

  return {
    quote,
    secondsRemaining,
    isExpired,
    refreshQuote: fetchQuote
  };
}

{
  "success": false,
  "error": {
    "code": "QUOTE_EXPIRED",
    "message": "Quote has expired. Please request a new quote."
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_NETWORK",
    "message": "The specified network is not supported for this currency."
  }
}