为何突然触发CoinGecko API的"请求超出速率限制"错误？

7月23日，运行在Google Apps Script中的代码突然停止运行，调用Coin Gecko API时返回429状态码（限流超限）。

运行环境与背景 #

• 在Google Apps Script中执行代码
• 每日仅发起14次Coin Gecko API调用，远低于免费版50次/分钟的速率限制
• Coin Gecko官方限流规则：单IP 8次/秒，免费版50次/分钟
• 已使用Utilities.sleep()做请求间隔处理
• 直接用浏览器访问API端点正常
• 此前遇到的服务器繁忙提示与本次429错误信息不同

错误信息 #

Exception: 请求访问https://api.coingecko.com失败，返回状态码429。服务器截断响应：{"status":{"error_code":429, "error_message": "You've exceeded the Rate Limit. Please visit https://www.coingecko.com/en/api/pricing to subscribe to ... (use the muteHttpExceptions option to examine the full response)

测试代码 #

function test() {
  const URL = 'https://api.coingecko.com/api/v3/coins/bitcoin'
  
  Utilities.sleep(10000)
  const fetchedData1 = UrlFetchApp.fetch(url)
  console.log(fetchedData1)

  Utilities.sleep(10000)
  const fetchedData2 = UrlFetchApp.fetch(url)
  console.log(fetchedData2)
  
}

1. 先修复代码语法问题 #

测试代码中定义了大写的URL常量，但调用UrlFetchApp.fetch()时用了小写的url，这会导致未定义错误，先统一变量大小写：

function test() {
  const url = 'https://api.coingecko.com/api/v3/coins/bitcoin'
  
  Utilities.sleep(10000)
  const fetchedData1 = UrlFetchApp.fetch(url)
  console.log(fetchedData1)

  Utilities.sleep(10000)
  const fetchedData2 = UrlFetchApp.fetch(url)
  console.log(fetchedData2)
  
}

2. 核心原因：Google Apps Script的共享IP池 #

Google Apps Script的请求从Google共享IP池发出，多个用户共用同一IP，哪怕你的调用量极低，也可能因为同IP下其他用户的请求总和触发Coin Gecko的限流。这是本次429错误的最可能原因。

对应解决办法：

• 启用muteHttpExceptions获取完整响应，确认限流的具体触发类型：

  const response = UrlFetchApp.fetch(url, { muteHttpExceptions: true });
  console.log(response.getContentText());
  

• 延长请求间隔，比如从10秒调整到15-20秒，降低共享IP上的请求密度
• 添加自定义User-Agent请求头，帮助Coin Gecko区分请求来源：

  const options = {
    headers: {
      'User-Agent': '你的GAS项目名称/1.0'
    },
    muteHttpExceptions: true
  };
  const fetchedData1 = UrlFetchApp.fetch(url, options);
  

3. 实现指数退避重试机制 #

针对429错误添加自动重试逻辑，触发限流时按指数延长等待时间：

function fetchWithRetry(url, maxRetries = 3) {
  let retryCount = 0;
  while (retryCount < maxRetries) {
    try {
      const options = {
        headers: { 'User-Agent': '你的GAS项目名称/1.0' },
        muteHttpExceptions: true
      };
      const response = UrlFetchApp.fetch(url, options);
      if (response.getResponseCode() === 429) {
        const waitTime = Math.pow(2, retryCount) * 10000; // 等待时间：10s→20s→40s
        Utilities.sleep(waitTime);
        retryCount++;
        continue;
      }
      return response;
    } catch (e) {
      retryCount++;
      if (retryCount >= maxRetries) throw e;
      Utilities.sleep(10000);
    }
  }
  throw new Error('达到最大重试次数');
}

// 使用示例
function test() {
  const url = 'https://api.coingecko.com/api/v3/coins/bitcoin';
  const data1 = fetchWithRetry(url);
  console.log(data1.getContentText());
  Utilities.sleep(15000);
  const data2 = fetchWithRetry(url);
  console.log(data2.getContentText());
}

4. 确认Coin Gecko限流规则变动 #

虽然官方标注免费版是50次/分钟，但可能临时调整了策略或针对Google IP池做了特殊限制，通过完整响应可以确认错误详情，再对应调整请求频率。

内容的提问来源于stack exchange，提问作者Jinn Jinn