{"openapi":"3.0.3","info":{"title":"GradioAPI Arbitrage","version":"2.5.0","description":"Xypher arbitrage and Footlive scores. Arbitrage retains all source assets and quotes; gross spreads and source warnings do not imply executable net profit. Baby Mystic generates one fictional baby portrait asynchronously from two uploaded photos. Authenticated mobile generation for HomeDesign, LookyAI and TattooARAI is available under /mobile/v1."},"paths":{"/arbitrage":{"get":{"operationId":"getArbitrage","summary":"getArbitrage","description":"Six requested exchanges, top_100=true. All returned assets and quotes retained. Best distinct-exchange positive spread per market; no default spread ceiling. asks/bids retain source prices; warnings flag >10% spreads and crossed books.","parameters":[{"name":"coin","in":"query","schema":{"type":"string"},"description":"Case-insensitive symbol substring across all Xypher source assets."},{"name":"exchange","in":"query","schema":{"type":"string"},"description":"Case-insensitive code/name filter applied before selecting the best venue pair."},{"name":"min_spread","in":"query","schema":{"type":"number","minimum":0,"default":0}},{"name":"max_spread","in":"query","schema":{"type":"number","minimum":0},"description":"Optional ceiling; omitted or empty means unlimited."},{"name":"limit","in":"query","schema":{"type":"integer","default":5000,"minimum":1,"maximum":5000}}],"security":[{"ApiKey":[]}],"responses":{"200":{"description":"Array; empty means no qualifying spread on supported markets, not a provider failure. X-Data-Partial and X-Failed-Sources disclose degraded coverage.","headers":{"X-Data-As-Of":{"schema":{"type":"string"}},"X-Data-Age-Seconds":{"schema":{"type":"string"}},"X-Data-Sources":{"schema":{"type":"string"}},"X-Failed-Sources":{"schema":{"type":"string"}},"X-Data-Partial":{"schema":{"type":"string"}},"X-Price-Meaning":{"schema":{"type":"string"}},"X-Source-Timestamp-Available":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["coin_name","main_market","exchange_from","exchange_to","profit_percent","url_from","url_to","buy_price","sell_price","gross_spread_percent","profit_is_gross","fetched_at","source"],"properties":{"coin_name":{"type":"string"},"main_market":{"type":"string"},"exchange_from":{"type":"string"},"exchange_to":{"type":"string"},"profit_percent":{"type":"number","description":"Legacy field. Gross spread, not net profit."},"url_from":{"type":"string","format":"uri"},"url_to":{"type":"string","format":"uri"},"buy_price":{"type":"number","description":"Ask price"},"sell_price":{"type":"number","description":"Bid price"},"gross_spread_percent":{"type":"number","description":"Gross bid/ask spread before all costs; not executable net profit."},"profit_is_gross":{"type":"boolean","enum":[true]},"fetched_at":{"type":"string","format":"date-time","description":"Retrieval start time, not exchange quote timestamp."},"source":{"type":"string"},"asks":{"type":"array","items":{"type":"object","properties":{"exchange":{"type":"string"},"price":{"type":"number"}}}},"bids":{"type":"array","items":{"type":"object","properties":{"exchange":{"type":"string"},"price":{"type":"number"}}}},"warnings":{"type":"array","items":{"type":"string"}}}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or missing key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream error, invalid schema, or insufficient sources","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Missing required configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Upstream timeout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/get_footlivedata":{"get":{"operationId":"getFootliveData","summary":"Footlive scores","description":"Legacy string-valued fields. query matches any field case-insensitively. 5-second snapshot cache. Existing X-API-Key required.","security":[{"ApiKey":[]}],"parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["","livenow","today","yesterday","tomorrow"],"default":""}},{"name":"query","in":"query","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Match list. Empty list is possible when no matches qualify.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["id","status","minute","score1","score2","date","comp","team1","team2","slug1","slug2","rc1","rc2","pen1","pen2","dtb","hh","is_last"],"properties":{"id":{"type":"string"},"status":{"type":"string"},"minute":{"type":"string"},"score1":{"type":"string"},"score2":{"type":"string"},"date":{"type":"string"},"comp":{"type":"string"},"team1":{"type":"string"},"team2":{"type":"string"},"slug1":{"type":"string"},"slug2":{"type":"string"},"rc1":{"type":"string"},"rc2":{"type":"string"},"pen1":{"type":"string"},"pen2":{"type":"string"},"dtb":{"type":"string"},"hh":{"type":"string"},"is_last":{"type":"string"}}}}}}},"400":{"description":"Invalid query"},"401":{"description":"Invalid key"},"502":{"description":"Upstream or HTML schema error"},"503":{"description":"Authentication not configured"},"504":{"description":"Upstream timeout"}}}},"/baby-generator":{"post":{"operationId":"createBabyPortrait","summary":"Create a fictional baby portrait","description":"One paid generation attempt: fixed 512x728 and 25 steps. JPEG/PNG/WebP, max 2 MiB each. Returns a signed status_url valid for one hour. Never automatically retry a timed-out POST; it may have started.","security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["father_image","mother_image","consent"],"properties":{"father_image":{"type":"string","format":"binary"},"mother_image":{"type":"string","format":"binary"},"gender":{"type":"string","enum":["boy","girl"],"default":"boy"},"consent":{"type":"string","enum":["true"],"description":"Permission to process both photos with Replicate."}}}}}},"responses":{"202":{"description":"Generation accepted; poll status_url. One Generations unit.","headers":{"X-RapidAPI-Billing":{"schema":{"type":"string"},"description":"Generations=1"}},"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"status":{"type":"string","enum":["starting","processing","succeeded","failed","canceled"]},"status_url":{"type":"string"},"output_url":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"notice":{"type":"string"}}}}}},"400":{"description":"Invalid images or missing consent"},"401":{"description":"Unauthorized"},"413":{"description":"Upload too large"},"415":{"description":"Use multipart/form-data"},"429":{"description":"Provider rate limit"},"502":{"description":"Provider error"},"503":{"description":"Replicate token not configured"},"504":{"description":"Submission outcome uncertain; do not auto-retry"}}}},"/baby-generator/{job_id}":{"get":{"operationId":"getBabyPortrait","summary":"Check existing baby portrait job","description":"Poll every 2.5 seconds or slower. Does not start a new generation. Same caller must poll. Output URL is temporary; download completed results.","security":[{"ApiKey":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"},"description":"Signed job_id returned by POST; not a raw Replicate ID."}],"responses":{"200":{"description":"Current status including failed/canceled. Generations=0.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"status":{"type":"string","enum":["starting","processing","succeeded","failed","canceled"]},"status_url":{"type":"string"},"output_url":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"notice":{"type":"string"}}}}}},"404":{"description":"Unknown or unauthorized job"},"410":{"description":"Expired job token"}}}},"/hair-style":{"post":{"operationId":"generateHairstyle","summary":"Change hairstyle and hair color","tags":["Hair Style"],"security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["image","consent"],"properties":{"image":{"type":"string","format":"binary","description":"JPEG or PNG; max 2 MB; resize to fit within 500x500 before upload."},"style":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","custom"],"default":"1"},"color":{"type":"string","enum":["keep","random","black","white","pink","violet","deep-red","red","brown","blonde","yellow","orange","ginger","cyan","green","blue","iridescent"],"default":"keep"},"description":{"type":"string","maxLength":500,"description":"Required when style=custom; otherwise ignored."},"consent":{"type":"string","enum":["true"]}}}}}},"responses":{"200":{"description":"Generated image as Base64. Decode image_base64 with mime_type. One generation is billed.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"succeeded"},"image_base64":{"type":"string","format":"byte"},"mime_type":{"type":"string","enum":["image/jpeg","image/png"]},"width":{"type":"integer","example":512},"height":{"type":"integer","example":768},"style":{"type":"string"},"color":{"type":"string"},"model":{"type":"string"},"notice":{"type":"string"}}}}}},"400":{"description":"Invalid fields or image dimensions"},"401":{"description":"Invalid API credentials"},"413":{"description":"Image too large"},"415":{"description":"Use multipart/form-data"},"502":{"description":"AI service error"},"503":{"description":"Service not configured"},"504":{"description":"Generation timeout; do not automatically retry"}}}},"/hair-styles":{"get":{"operationId":"listHairstyles","summary":"List available styles, preview URLs and colors","security":[{"ApiKey":[]}],"tags":["Hair Style"],"responses":{"200":{"description":"Style catalog; no generation charge."},"401":{"description":"Invalid API credentials"}}}},"/mobile/v1/{app}/jobs":{"post":{"operationId":"createMobileGeneration","summary":"Create or resume an app generation","security":[{"FirebaseIdToken":[]}],"parameters":[{"name":"app","in":"path","required":true,"schema":{"type":"string","enum":["homedesign","lookyai","tattooarai"]}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["operation","prompt"],"properties":{"operation":{"type":"string","enum":["interior","photoshoot","video","tattoo"]},"prompt":{"type":"string","maxLength":8000},"image":{"type":"string","description":"JPEG/PNG/WebP data URI. Required except tattoo."}}}}}},"responses":{"200":{"description":"Completed job"},"202":{"description":"Job accepted; poll using job_id"},"401":{"description":"Firebase authentication required"},"409":{"description":"Request ID already used with different input"},"429":{"description":"Rate or daily limit reached"}}}},"/mobile/v1/{app}/jobs/{job_id}":{"get":{"operationId":"getMobileGeneration","summary":"Read a generation owned by this app/user","security":[{"FirebaseIdToken":[]}],"parameters":[{"name":"app","in":"path","required":true,"schema":{"type":"string","enum":["homedesign","lookyai","tattooarai"]}},{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Terminal job status with output_url or error"},"202":{"description":"Job still pending"},"404":{"description":"Job not found for this user"}}}}},"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key"},"FirebaseIdToken":{"type":"http","scheme":"bearer","bearerFormat":"Firebase JWT"}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object"}}}}}}}}