{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://zieapi.vercel.app"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/finance:coingecko/categories":{"get":{"operationId":"finance_coingecko_categories","summary":"Categories","description":"Coin categories with aggregate market cap and 24h volume.","tags":["finance"],"parameters":[{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["market_cap_desc","market_cap_asc","name_desc","name_asc","market_cap_change_24h_desc","market_cap_change_24h_asc"],"default":"market_cap_desc"}},{"name":"query","in":"query","required":false,"description":"Filter categories by name","schema":{"type":"string","description":"Filter categories by name"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":300,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/finance:coingecko/exchanges":{"get":{"operationId":"finance_coingecko_exchanges","summary":"Exchanges","description":"Crypto exchanges ranked by trust score with 24h BTC volume.","tags":["finance"],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":250}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":300,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/finance:coingecko/vs-currencies":{"get":{"operationId":"finance_coingecko_vs_currencies","summary":"Supported vs Currencies","description":"List of quote currencies accepted by the price endpoints.","tags":["finance"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/finance:coingecko/global":{"get":{"operationId":"finance_coingecko_global","summary":"Global","description":"Total crypto market cap, volume and dominance figures.","tags":["finance"],"parameters":[{"name":"vsCurrency","in":"query","required":false,"description":"Only return totals in this currency, e.g. usd","schema":{"type":"string","description":"Only return totals in this currency, e.g. usd"}},{"name":"limit","in":"query","required":false,"description":"Max dominance entries","schema":{"type":"integer","minimum":1,"maximum":50,"description":"Max dominance entries"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":120,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/finance:coingecko/coins-markets":{"get":{"operationId":"finance_coingecko_coins_markets","summary":"Coins Markets","description":"Ranked coin list with price, market cap, volume and price change.","tags":["finance"],"parameters":[{"name":"vsCurrency","in":"query","required":false,"schema":{"type":"string","default":"usd"}},{"name":"ids","in":"query","required":false,"description":"Restrict to these coin ids (comma-separated)","schema":{"type":"string","description":"Restrict to these coin ids (comma-separated)"}},{"name":"category","in":"query","required":false,"description":"CoinGecko category id, e.g. layer-1","schema":{"type":"string","description":"CoinGecko category id, e.g. layer-1"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["market_cap_desc","market_cap_asc","volume_desc","volume_asc","id_desc","id_asc"],"default":"market_cap_desc"}},{"name":"priceChangePercentage","in":"query","required":false,"description":"Extra change windows","schema":{"type":"string","description":"Extra change windows"},"example":"1h,24h,7d"},{"name":"precision","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":250}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/finance:coingecko/simple-price":{"get":{"operationId":"finance_coingecko_simple_price","summary":"Simple Price","description":"Current price of one or more coins in one or more fiat/crypto currencies.","tags":["finance"],"parameters":[{"name":"ids","in":"query","required":true,"description":"Comma-separated CoinGecko coin ids","schema":{"type":"string","description":"Comma-separated CoinGecko coin ids"},"example":"bitcoin,ethereum"},{"name":"vsCurrencies","in":"query","required":false,"description":"Comma-separated quote currencies","schema":{"type":"string","default":"usd,idr","description":"Comma-separated quote currencies"}},{"name":"includeMarketCap","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"true"}},{"name":"include24hVol","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"true"}},{"name":"include24hChange","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"true"}},{"name":"precision","in":"query","required":false,"description":"Decimal places (0-18) or 'full'","schema":{"type":"string","description":"Decimal places (0-18) or 'full'"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":30,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/finance:coingecko/derivatives":{"get":{"operationId":"finance_coingecko_derivatives","summary":"Derivatives","description":"Derivative tickers across exchanges with funding rate, basis and open interest.","tags":["finance"],"parameters":[{"name":"market","in":"query","required":false,"description":"Filter by exchange/market name","schema":{"type":"string","description":"Filter by exchange/market name"}},{"name":"indexId","in":"query","required":false,"schema":{"type":"string"},"example":"BTC"},{"name":"symbol","in":"query","required":false,"description":"Filter by contract symbol (substring)","schema":{"type":"string","description":"Filter by contract symbol (substring)"}},{"name":"contractType","in":"query","required":false,"schema":{"type":"string","enum":["perpetual","futures"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":120,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/finance:coingecko/ping":{"get":{"operationId":"finance_coingecko_ping","summary":"Ping","description":"Checks whether the CoinGecko API is reachable.","tags":["finance"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":30,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}