Files
sdk/docs/MarketsApi.md
zeekayandHanzo Dev b55332704a feat: Hanzo Cloud SDK for Kotlin (generated from OpenAPI v8.0.0)
Coroutine-native client covering the full Hanzo /v1 cloud surface, for JVM and
Android. Generated with openapi-generator kotlin (library=jvm-okhttp4,
useCoroutines=true). Coordinate: ai.hanzo:sdk. Base URL: https://api.hanzo.ai.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-25 07:10:32 -07:00

17 KiB

MarketsApi

All URIs are relative to https://api.hanzo.ai

Method HTTP request Description
worldWorldCoingecko GET /v1/world/coingecko Crypto spot prices (CoinGecko)
worldWorldEia GET /v1/world/eia US EIA energy data (requires EIA_API_KEY)
worldWorldEtfFlows GET /v1/world/etf-flows BTC/crypto ETF flows
worldWorldFinnhub GET /v1/world/finnhub Market data (Finnhub; requires FINNHUB_KEY)
worldWorldFredData GET /v1/world/fred-data FRED economic series (requires FRED_API_KEY)
worldWorldIndicators GET /v1/world/indicators Trader indicator suite (VIX/VVIX/MOVE, yield curve + 2s10s, crypto/equity fear-greed, momentum, sector breadth, BTC dominance + perp funding, DXY/metals, risk-on/off composite)
worldWorldMacroSignals GET /v1/world/macro-signals Macro market-radar signals
worldWorldPolymarket GET /v1/world/polymarket Prediction markets (Polymarket gamma)
worldWorldSentiment GET /v1/world/sentiment Realtime news-sentiment index (GDELT tone: global + per-topic + per-region, 24h sparkline + velocity)
worldWorldStablecoinMarkets GET /v1/world/stablecoin-markets Stablecoin market health
worldWorldStockIndex GET /v1/world/stock-index Stock index snapshot
worldWorldWorldbank GET /v1/world/worldbank World Bank indicators
worldWorldYahooFinance GET /v1/world/yahoo-finance Equity/index quotes (Yahoo)

worldWorldCoingecko

kotlin.Any worldWorldCoingecko()

Crypto spot prices (CoinGecko)

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldCoingecko()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldCoingecko")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldCoingecko")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldEia

kotlin.Any worldWorldEia()

US EIA energy data (requires EIA_API_KEY)

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldEia()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldEia")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldEia")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldEtfFlows

kotlin.Any worldWorldEtfFlows()

BTC/crypto ETF flows

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldEtfFlows()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldEtfFlows")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldEtfFlows")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldFinnhub

kotlin.Any worldWorldFinnhub(symbol)

Market data (Finnhub; requires FINNHUB_KEY)

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
val symbol : kotlin.String = symbol_example // kotlin.String | 
try {
    val result : kotlin.Any = apiInstance.worldWorldFinnhub(symbol)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldFinnhub")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldFinnhub")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
symbol kotlin.String

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldFredData

kotlin.Any worldWorldFredData(seriesId)

FRED economic series (requires FRED_API_KEY)

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
val seriesId : kotlin.String = seriesId_example // kotlin.String | 
try {
    val result : kotlin.Any = apiInstance.worldWorldFredData(seriesId)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldFredData")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldFredData")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
seriesId kotlin.String

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldIndicators

kotlin.Any worldWorldIndicators()

Trader indicator suite (VIX/VVIX/MOVE, yield curve + 2s10s, crypto/equity fear-greed, momentum, sector breadth, BTC dominance + perp funding, DXY/metals, risk-on/off composite)

The classic trader dashboard in one call, every field from a free/no-key upstream (Yahoo charts, alternative.me, CoinGecko global, exchange funding). Each field degrades to null when its source is down; the equity fear/greed and risk-on/off composites recompute over surviving inputs and ship their formulas inline. Cached ~2 min. Always 200 (never 5xx).

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldIndicators()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldIndicators")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldIndicators")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldMacroSignals

kotlin.Any worldWorldMacroSignals()

Macro market-radar signals

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldMacroSignals()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldMacroSignals")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldMacroSignals")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldPolymarket

kotlin.Any worldWorldPolymarket()

Prediction markets (Polymarket gamma)

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldPolymarket()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldPolymarket")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldPolymarket")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldSentiment

kotlin.Any worldWorldSentiment()

Realtime news-sentiment index (GDELT tone: global + per-topic + per-region, 24h sparkline + velocity)

Realtime news sentiment aggregated from GDELT article tone. Returns a global sentiment index (0-100 = clamp(50 + tone·5)), per-topic (markets/conflict/energy/tech) and per-region breakdowns, each with a 24h tone sparkline and velocity (rate of change). GDELT rate-limits to 1 req/5s, so the endpoint serves a cached value instantly and refreshes in the background at a paced cadence; until the first refresh lands it returns a clean `status:&quot;warming&quot;` body. Always 200 (never 5xx).

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldSentiment()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldSentiment")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldSentiment")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldStablecoinMarkets

kotlin.Any worldWorldStablecoinMarkets()

Stablecoin market health

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldStablecoinMarkets()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldStablecoinMarkets")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldStablecoinMarkets")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldStockIndex

kotlin.Any worldWorldStockIndex()

Stock index snapshot

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
try {
    val result : kotlin.Any = apiInstance.worldWorldStockIndex()
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldStockIndex")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldStockIndex")
    e.printStackTrace()
}

Parameters

This endpoint does not need any parameter.

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldWorldbank

kotlin.Any worldWorldWorldbank(indicator, country)

World Bank indicators

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
val indicator : kotlin.String = indicator_example // kotlin.String | 
val country : kotlin.String = country_example // kotlin.String | 
try {
    val result : kotlin.Any = apiInstance.worldWorldWorldbank(indicator, country)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldWorldbank")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldWorldbank")
    e.printStackTrace()
}

Parameters

| indicator | kotlin.String| | [optional] |

Name Type Description Notes
country kotlin.String [optional]

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

worldWorldYahooFinance

kotlin.Any worldWorldYahooFinance(symbol)

Equity/index quotes (Yahoo)

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = MarketsApi()
val symbol : kotlin.String = symbol_example // kotlin.String | 
try {
    val result : kotlin.Any = apiInstance.worldWorldYahooFinance(symbol)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling MarketsApi#worldWorldYahooFinance")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling MarketsApi#worldWorldYahooFinance")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
symbol kotlin.String

Return type

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json