{"openapi":"3.0.3","info":{"title":"LaunchClaw — Auto Trading Agents API","version":"1.0.0","description":"Public Auto Trading Agents API on chain 4663. Discover LaunchClaw launches and get unsigned swap/launch calldata. No key required (IP rate-limited). Optional X-Api-Key (keyId.secret) for higher RPM. SSE /launches/stream covers Fast Track + V4 Easy/Custom day-1 DEX; poll lane=curve for legacy bonding-curve launches. Bots sign locally."},"servers":[{"url":"https://www.fatcatcapital.fun"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Optional. Format: keyId.secret — higher RPM than public IP limit."}},"schemas":{"AgentLaunch":{"type":"object","properties":{"launchId":{"type":"string"},"token":{"type":"string"},"curve":{"type":"string"},"pool":{"type":"string","nullable":true},"factory":{"type":"string"},"creator":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"instant":{"type":"boolean"},"lane":{"type":"string","enum":["fast","easy","curve"]},"createdAt":{"type":"integer"},"chainId":{"type":"integer","example":4663}}},"SwapBody":{"type":"object","required":["side","token","amountIn","recipient"],"properties":{"side":{"type":"string","enum":["buy","sell"]},"token":{"type":"string"},"amountIn":{"type":"string","description":"Wei integer string"},"recipient":{"type":"string"},"slippageBps":{"type":"integer","default":150}}}}},"paths":{"/api/v1/health":{"get":{"summary":"Public health","security":[],"responses":{"200":{"description":"OK"}}}},"/api/v1/launches":{"get":{"summary":"Poll launches","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"lane","in":"query","schema":{"type":"string","enum":["fast","easy","curve","all"],"default":"fast"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"integer","description":"Unix seconds"}}],"responses":{"200":{"description":"Launch list"}}}},"/api/v1/launches/stream":{"get":{"summary":"SSE live feed (Fast Track + V4 day-1 DEX)","description":"Snapshot + deltas for Fast Track and single-sided Easy/Custom. Poll GET /api/v1/launches?lane=curve|all for legacy bonding-curve launches.","security":[{"ApiKeyAuth":[]},{}],"responses":{"200":{"description":"text/event-stream"}}}},"/api/v1/token/{address}":{"get":{"summary":"Token / launch meta by token address","description":"LaunchClaw launch row + joined Uni pool when known. 404 if not indexed.","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"{ token: AgentToken }"},"404":{"description":"not_found"}}}},"/api/v1/quote":{"post":{"summary":"Quote + unsigned tx preview","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapBody"}}}},"responses":{"200":{"description":"Quote"}}}},"/api/v1/swap":{"post":{"summary":"Unsigned swap calldata only","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapBody"}}}},"responses":{"200":{"description":"{ to, data, value, chainId, deadline }"}}}},"/api/v1/launch":{"post":{"summary":"Unsigned Easy / Fast / Custom (LaunchClaw) or pools (Uniswap Instant Launch)","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","symbol"],"properties":{"mode":{"type":"string","enum":["easy","fast","custom","pools"],"default":"easy","description":"pools = Uniswap Instant Launch (not LaunchClaw 90/10). Requires creator."},"name":{"type":"string"},"symbol":{"type":"string"},"seedEth":{"type":"string","description":"Required for fast — LP seed ETH"},"creator":{"type":"string","description":"Signer wallet — fee quote + launchesInWindow"},"tradeFeePct":{"type":"number","default":1},"factory":{"type":"string","enum":["uni","sushi"]},"lockPct":{"type":"number","description":"Custom creator cliff % (10–50)"},"unlockDays":{"type":"integer","description":"Custom vault cliff days (10–90)","minimum":10,"maximum":90}}}}}},"responses":{"200":{"description":"{ to, data, value, mode, … }"}}}}}}