--- name: x402.swaphunt.dev description: x402.swaphunt.dev provides two cryptocurrency market data skills: a live price snapshot for a given asset/currency pair, and an intraday range exhaustion indicator based on ATR(14). Both are single-shot, cached endpoints suited for point-in-time analysis rather than streaming feeds. host: x402.swaphunt.dev --- # x402.swaphunt.dev SwapHunt is a lightweight crypto market data host targeting agents that need quick intraday context on price and range consumption. It serves use cases like pre-trade checks, directional bias assessment, and price display — not order execution, DEX routing, or historical backtesting. Its two skills are narrow and complementary: one gives the current price, the other contextualizes how much of the day's expected range has already been used. ## When to use this host Use this host when an agent needs a fast, single-shot intraday price snapshot or wants to assess daily range exhaustion for a crypto asset before making a decision. It is appropriate for pre-trade context checks and directional bias filtering. Do not use it for streaming or tick-level price data, multi-day or historical range analysis, token swap routing (use a DEX quote API), or order execution. If you need OHLCV history, candlestick data, or on-chain analytics, this host does not provide those — look for a dedicated market data or analytics provider instead. ## Capabilities ### Intraday Price Context Provides the current market price and 24h statistics for a crypto asset, forming the baseline data layer for any intraday decision. - **`fetch-asset-price-quote`** — Returns the current market price for a cryptocurrency asset in a target currency, including 24h change, high, low, volume, and update timestamp. ### Range Exhaustion Analysis Measures how much of the ATR(14)-derived daily range has been consumed, returning a directional verdict and range status to assess whether significant intraday movement remains likely. - **`fetch-btc-daily-range-used`** — Returns how much of the expected daily ATR(14) range has been consumed for a given asset/quote pair, along with current price, today's high/low/open, range status, and a directional verdict. ## Workflows ### Intraday Opportunity Assessment *Use when an agent needs to evaluate whether a crypto asset has meaningful price movement potential remaining in the current trading day before acting on a signal.* 1. **`fetch-asset-price-quote`** — Retrieve the current price, 24h high/low, and change to establish the live market context for the asset. 2. **`fetch-btc-daily-range-used`** — Check what percentage of the expected daily ATR range has been consumed and read the directional verdict to determine whether significant intraday movement is still likely. ## Skill reference ### `fetch-btc-daily-range-used` **BTC Daily Range Used** — Returns how much of the expected daily ATR(14) range has been consumed for a given asset/quote pair, along with current price, today's high/low/open, range status, and a directional verdict. *Use when:* Use when an agent needs to assess intraday range exhaustion for a crypto asset — e.g., to determine whether significant price movement remains likely today or whether the daily range is mostly consumed. *Not for:* Do not use for multi-day range analysis or historical range queries; this endpoint reflects only the current trading day cached up to 5 minutes. Not suitable for streaming or tick-level price data. **Inputs:** - `asset` (string) — Asset symbol to query (e.g. BTC, ETH, SOL). Defaults to BTC. - `quote` (string) — Quote currency for the pair (e.g. USDT, USDC, EUR). Defaults to USDT. **Returns:** Returns range_used_pct (38.3%), range_status ('low'), today's high/low/open, current price, ATR(14), directional change, and a plain-language verdict for the BTCUSDT pair. **Example:** `GET https://x402.swaphunt.dev/v1/cycle/daily-range-used?asset=BTC"e=USDT` --- ### `fetch-asset-price-quote` **SwapHunt Asset Price Quote** — Returns the current market price for a cryptocurrency asset in a target currency, including 24h change, high, low, volume, and update timestamp. *Use when:* Use when an agent needs a live market price snapshot for a cryptocurrency (e.g. BTC, ETH, SOL) in a specified fiat or crypto currency (e.g. USD, EUR), including 24h statistics. *Not for:* Do not use for streaming or real-time tick-by-tick price feeds; this is a single-shot snapshot. Do not use for token swap quotes or routing — use a DEX quote API instead. **Inputs:** - `asset` (string) — Cryptocurrency symbol to price (e.g. BTC, ETH, SOL). Defaults to BTC. - `currency` (string) — Target currency for the price (e.g. USD, EUR). Defaults to USD. **Returns:** Returns a JSON object with asset, price, currency, change_24h, high_24h, low_24h, volume_24h, and updated_at for the requested asset/currency pair. **Example:** `GET https://x402.swaphunt.dev/v1/tools/price?asset=BTC¤cy=USD` ---