{"openapi":"3.0.3","info":{"title":"STARC Data API","version":"1.0.0","description":"Public read API for STARC launches on Arc. Writes are on-chain only — agents use their own wallet with addresses from GET /config. Rate limits: 60 req/min per IP (30/min on heavy routes).","contact":{"url":"https://starc.run/docs/developers"}},"servers":[{"url":"https://starc.run/api/v1"}],"paths":{"/config":{"get":{"summary":"Chain + contract addresses + fees (no DB)","responses":{"200":{"description":"Config payload"}}}},"/markets":{"get":{"summary":"List launches","parameters":[{"name":"kind","in":"query","schema":{"type":"string","enum":["discovery","fuse","livo"]}},{"name":"phase","in":"query","schema":{"type":"string"},"description":"Filter after fetch (e.g. Active, Live)"},{"name":"sort","in":"query","schema":{"type":"string","enum":["new","volume","progress"],"default":"new"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":5000,"default":0}}],"responses":{"200":{"description":"Market list"}}}},"/markets/{id}":{"get":{"summary":"Launch detail by launch_id or market address","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Market detail"},"404":{"description":"Not found"}}}},"/markets/{id}/trades":{"get":{"summary":"Recent trades (heavy — 30/min)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Trade list"}}}},"/search":{"get":{"summary":"Search by name/symbol (heavy — 30/min)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":64}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":30,"default":20}}],"responses":{"200":{"description":"Search hits"}}}},"/stats":{"get":{"summary":"Protocol aggregates (cached 30s)","responses":{"200":{"description":"Stats"}}}},"/position/{market}/{wallet}":{"get":{"summary":"Indexed position for a wallet on a market","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"name":"wallet","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Position"}}}},"/profile/{address}":{"get":{"summary":"Wallet launches + positions (heavy — 30/min)","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Profile"}}}},"/upload":{"post":{"summary":"Upload token logo (alias of /api/logo)","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["creator","file"],"properties":{"creator":{"type":"string","description":"0x creator"},"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Public logo URL"}}}},"/openapi":{"get":{"summary":"This OpenAPI document","responses":{"200":{"description":"OpenAPI 3 JSON"}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}}}}}}