Kraken (public market data)#

finance-query = { version = "...", features = ["kraken"] }

Kraken's public endpoints (api.kraken.com/0/public/*) need no API key and impose no geo-block — which is the reason this provider exists alongside Binance, whose data is richer but unavailable to US retail users.

Two exchanges also give Capability::CRYPTO a real fallback chain:

use finance_query::{Capability, Fetch, Provider, Providers};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let providers = Providers::builder()
        .route(Capability::CRYPTO, [Provider::Binance, Provider::Kraken, Provider::CoinGecko])
        .fetch(Fetch::Sequential)
        .build()
        .await?;
    Ok(())
}

Capabilities#

use finance_query::{Capability, Provider, Providers};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let providers = Providers::builder()
        .route(Capability::CRYPTO, [Provider::Kraken])
        .build()
        .await?;

    let btc = providers.crypto("bitcoin");
    let quote = btc.quote("usd").await?;
    println!("BTC {:?}", quote.price);
    Ok(())
}

Kraken's Own Symbol Conventions#

Kraken predates most ticker conventions and kept its own:

None of that reaches your call sites. Pass normal tickers, coin ids, or separated pairs and the adapter translates in both directions:

Kraken also answers with a pair name that differs from the one requested (XBTUSD comes back keyed as XXBTZUSD), so the adapter reads the response positionally rather than looking up the name it sent.

Response Notes#

CryptoQuote:

• volume_24h, high_24h, low_24h come from the rolling 24-hour half of Kraken's [today, last 24 hours] arrays, not today's figures.
• change_24h and change_percent_24h are measured against today's opening price (00:00 UTC). Kraken publishes no price from exactly 24 hours ago, so early in the UTC day this is a shorter-window change than the field name suggests.
• market_cap and circulating_supply are always None — an exchange knows flow, not supply. Route CRYPTO to CoinGecko for those.

Chart:

• Kraken timestamps candles in seconds already, so no conversion is applied.
• adj_close mirrors close — crypto has no corporate actions.

Intervals and History Depth#

Every library interval maps to a Kraken bucket except ThreeMonths, which returns NotSupported so sequential routing falls through. OneMonth maps to Kraken's longest bucket, 15 days.

Errors#

Kraken answers a rejected request with HTTP 200 and a populated error array, so the status code alone never means success. An unknown pair surfaces as FinanceError::SymbolNotFound; anything else carries Kraken's own error text.

Rate Limits#

Kraken's public counter allows roughly one call per second sustained for unauthenticated clients, and the client paces to match. That is deliberately slower than the Binance adapter — put Binance first in a chain if throughput matters and your region allows it.

Next Steps#

• Binance — deeper history, geo-blocked in some regions
• CoinGecko — aggregated market caps and supply
• Crypto Domain — the CryptoCoin handle