---
name: orionkr.xyz
description: orionkr.xyz provides two BTC-focused market signal endpoints: a directional momentum signal combining RSI and fear/greed index, and a kimchi premium snapshot comparing Korean exchange prices to global BTC prices. Both are single-shot query endpoints returning structured signals for pre-trade decision gating.
host: orionkr.xyz
---

# orionkr.xyz

orionkr.xyz is a narrow-purpose signal host targeting BTC trading agents that need pre-execution market checks. It serves agents operating in or around Korean crypto markets, offering a global BTC momentum signal and a Korea-specific spread signal. It does not cover non-BTC assets, streaming data, or trade execution.

## When to use this host

Use orionkr.xyz when an agent needs a quick pre-trade BTC sentiment or momentum check, or when evaluating Korea-global BTC price spreads for arbitrage-aware decision making. Do not use this host for non-BTC assets, multi-asset portfolio signals, real-time streaming price feeds, or trade execution — use a dedicated multi-asset price feed API or exchange integration instead. The kimchi premium skill requires a wallet address and chain parameter, suggesting it is designed for on-chain agent contexts interacting with Korean market data.

## Capabilities

### BTC Market Signals

Provides pre-trade directional and sentiment signals for BTC, including RSI, fear/greed index, confidence score, and current price, enabling agents to gate trade execution based on momentum conditions.

- **`fetch-btc-direction`** — Returns a BTC directional signal (UP/DOWN/NEUTRAL) with RSI, fear/greed index, confidence score, and current BTC price for pre-trade gating.

### Korea-Global Spread Analysis

Delivers a snapshot of the kimchi premium by comparing BTC prices on Upbit and Bithumb in KRW against Binance USD price and the USD/KRW rate, with a derived spread level and trading signal for cross-market arbitrage assessment.

- **`fetch-kimchi-premium-signal`** — Returns the current Korea-global BTC spread (kimchi premium), BTC prices on Upbit and Bithumb in KRW, Binance USD price, USD/KRW rate, spread level, and a trading signal.

## Workflows

### Korea BTC Trade Gate Check

*Use when an agent needs to evaluate both global BTC momentum and Korea-specific spread conditions before deciding whether to execute a BTC-related trade involving Korean exchanges.*

1. **`fetch-btc-direction`** — Retrieve global BTC directional signal, RSI, fear/greed index, and confidence score to assess whether overall market momentum supports trade execution.
2. **`fetch-kimchi-premium-signal`** — Retrieve the current kimchi premium and spread level to determine whether Korea-global price divergence creates favorable or unfavorable conditions for the intended trade.

## Skill reference

### `fetch-btc-direction`

**BTC Direction Check** — Returns a BTC directional signal (UP/DOWN/NEUTRAL) with RSI, fear/greed index, confidence score, and current BTC price for pre-trade gating.

*Use when:* Use when an agent needs to evaluate BTC market direction before executing a swap or trade, particularly to gate execution based on momentum, sentiment, and confidence thresholds.

*Not for:* Do not use for real-time streaming price feeds or for non-BTC assets; use a dedicated price feed or multi-asset signal API instead.

**Returns:** Returns direction (NEUTRAL/UP/DOWN), confidence score, 1h RSI, fear/greed index, BTC price in USD, 1h price change percent, timestamp, and usage guidance for trade gating.

**Example:** `GET https://orionkr.xyz/v1/btc-direction`

---

### `fetch-kimchi-premium-signal`

**Kimchi Premium Signal** — Returns the current Korea-global BTC spread (kimchi premium), BTC prices on Upbit and Bithumb in KRW, Binance USD price, USD/KRW rate, spread level, and a trading signal.

*Use when:* Use when an agent needs to assess the current kimchi premium between Korean crypto exchanges and global markets before making BTC-related trading decisions or evaluating cross-market arbitrage conditions.

*Not for:* Do not use for real-time streaming price feeds or non-BTC asset spreads; this is a single-shot snapshot of the Korea-global BTC spread only.

**Inputs:**

- `address` (string) — Base token, wallet, or contract address (optional, endpoint-dependent).
- `chain` (string) — Chain identifier; defaults to 'base'.

**Returns:** Returns kimchi_premium_pct, BTC prices on Upbit and Bithumb in KRW, Binance USD price, USD/KRW rate, a spread_level category, a trading signal string, and an updated_at timestamp.

**Example:** `GET https://orionkr.xyz/v1/kimchi-premium`

---