GMGN Agent API

🚧 GMGN API IP Blocked — Troubleshooting Guide ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【Step 1】 Identify the symptom There are TWO different issues, please tell us which one you see: • A Cloudflare challenge HTML page: "Sorry, you have been blocked" • An API response returning a 429 error ────────────────────────────── CASE A — Cloudflare "blocked" HTML page ────────────────────────────── 【Cause】 Your IP has very likely been intercepted by Cloudflare because the number of requests from a single IP exceeded 1,000 within one minute. 【How to resolve】 1. Pause ALL requests immediately. 2. Wait 15–20 minutes. 3. Try again to check if the connection is restored. Cloudflare will automatically release the block after this period. ────────────────────────────── CASE B — API returns error code 429 ────────────────────────────── If the API returns error code 429, STOP requesting immediately and lower your AI agent's API call frequency. 1. Wait 5 minutes, then retry and check if it works normally. 2. A 429 response also returns an "unfreeze" timestamp. Read this timestamp programmatically and only send requests AFTER it. ⚠️ NOTE: If you keep retrying within 5 minutes after a 429 error, the block window will be EXTENDED (the timer resets / pushes back). ────────────────────────────── 【Prevention】 Please check your invocation frequency first. Add some logs to see how many times you are actually requesting the "openapi.gmgn.ai" domain per minute, and keep it under the limit. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🚧 GMGN API IP 被封 — 排查指南 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【第一步】确认现象 以下是两种不同的问题，请告诉我们你遇到的是哪一种： • Cloudflare 拦截页面（HTML）："Sorry, you have been blocked" • API 返回 429 错误 ────────────────────────────── 情况 A —— Cloudflare "blocked" 拦截页面 ────────────────────────────── 【原因】 你的 IP 很可能已被 Cloudflare 拦截，原因是单个 IP 在一分钟内的 请求次数超过了 1,000 次。 【如何解决】 1. 立即暂停所有请求。 2. 等待 15–20 分钟。 3. 再次尝试，确认连接是否恢复。 过了这段时间后，Cloudflare 会自动解除封锁。 ────────────────────────────── 情况 B —— 接口返回 error code 429 ────────────────────────────── 如果接口返回的 error code 是 429，请立即停止请求，并降低 AI agent 的接口调用频率。 1. 等 5 分钟之后再重新尝试请求，看是否正常。 2. 429 还会额外返回一个「解冻时间戳」。可以程序化拿到这个 时间戳，并在该时间戳之后再发起请求。 ⚠️ 注意：如果你在 429 报错后的 5 分钟之内继续尝试请求，那么 这个 429 的拦截时间会顺延（封锁时间会被往后推）。 ────────────────────────────── 【预防建议】 请先检查你的调用频率。建议加一些日志，看看你实际每分钟请求 "openapi.gmgn.ai" 域名多少次，并将其控制在限制以内。