---
name: keespecs
description: Choose which KeeSpecs read to buy. Username, the KTA price, and simple lookups are free. Most other reads are 0.01 USDC, and free with limits while payments cannot settle. Stablecoin FX is 0.01 USDC. Desk, Network, and Convert Check are 0.02 USDC. Sending, bridging, banks, cards, and identity are at https://keeta.ai/llms.txt.
---

# KeeSpecs

## Which skill

- Whether paid reads can settle: read-x402-health. Free. If the facilitator is down, do not pay. Free reads still work.
- A keeta.xyz username, or the address that holds it: resolve-username. Free. Send only if verified is true. The name is not an on-chain proof.
- Whether the ledger, settlement, and the price sources are pass, fail, or unknown: read-status. 0.01 USDC. Free while payments are down (rate-limited). There is no score.
- Transactions per second or blocks per second alone: read-throughput. Do not quote lifetimeTps as the live rate.
- Settlement time, median and 95th: also read-throughput. It is a different call from the live rate.
- Base pool tape, whether the score is withheld, and whether Keeta itself is quiet: read-regime. The score is not a forecast.
- One token, or every token on an address: read-balance.
- Head, height, representative, and the published name: read-account.
- Events that touched an address, or only blocks it published: read-history.
- One block, when you already have the hash: read-block.
- Name, decimals, and supply for one token, or KTA, USDC, EURC, and cbBTC together: read-token.
- A ticker to the addresses that use it: search-tokens. Free. Official addresses come first.
- Whether a ticker or address is the official token, and which other tokens copy the code: read-token-check. 0.01 USDC. Free while payments are down (rate-limited). Not an audit. Stop if the address is not the official one.
- The moments the price sources crossed 1%, or agreed again: read-prices. GET https://keespecs.xyz/api/price-crossings. 0.01 USDC. Free while payments are down (rate-limited). Empty means no crossing since the baseline. moved may be keeta-fx.
- Which community token was sent most, or which official stablecoin moved: read-movers. largest is the five biggest amounts on that same page, in token units, not dollars. If covers12h is false, do not call it a 12-hour rank.
- AlpacaDEX 24-hour volume, price, and market cap in KTA: read-alpaca. Not 12 hours and not dollars.
- Every named token and its supply: read-directory. Not a price.
- Whether the Base anchor or the Bivo anchor moved: read-anchors. An empty list is not an outage.
- Who the resolver lists as an anchor, and what they connect: read-providers. Not a quote. A missing movement is not an outage.
- Which rail to use for a payout: read-corridors, the choose call. It returns one local rail and why the others were set aside. Not a quote.
- Whether a token can move from one chain to another: check-bridge-route. 0.01 USDC. Free while payments are down (rate-limited). It checks LayerZero, Bridge.xyz, and Keeta's Base bridge. canMove false means stop. It is not a quote and it does not start a bridge.
- How far a $K or $KB stablecoin is from 1:1: read-stablecoin-fx. 0.01 USDC. Free while payments are down (rate-limited). Not a quote. USDC and EURC are not on this anchor.
- Whether to convert or bridge right now: read-convert-check. 0.02 USDC. While payments are down, a bridge check returns the last paid answer marked stale:true with its asOf, for up to 10 minutes, then 503. A conversion still answers 503. no-go means stop. Not a quote or a guarantee.
- What changed since a date, for rails, fees, the KTA price, or the live rate: read-corridors, the changes call. An empty list is a quiet baseline, not an outage.
- Where money can move between Keeta and a bank or card, and the published fee: read-corridors. Not a quote and not an FX rate. verification.designator copied means the fee was copied from the publisher. The signature is not checked.
- Which apps are in the KeeSpecs registry, and which Keeta products are named: read-ecosystem. Not a ranking.
- Who may act on an account: read-permissions. This does not change permissions.
- Who holds voting weight: read-representatives.
- Network id and token addresses: mainnet-constants. That skill is free.
- Keeta storage limits, in bytes: read-storage-quotas. 0.01 USDC. Free while payments are down (rate-limited). 10 MiB per object, 100 MiB per user. live is false when an older copy is reused.
- Keeta settlement time: read-bridge-speed. 0.01 USDC. Free while payments are down (rate-limited). The timed figure is an internal hop inside one vote staple, not full settlement, so score stays null and label stays unknown. Not a guarantee of future transfer times. Measured on Keeta only. Does not include time spent on the Corridor chain.
- Whether an account can store on Keeta right now: persist-check. 0.02 USDC. It is not free while payments are down: that call returns 503. A bad address returns 400 and is not charged. ready never includes reasons.

## How a call is bought

- GET the URL with its required query and no payment header. The response is 402, with a PAYMENT-REQUIRED header for that exact URL.
- Check GET https://keespecs.xyz/api/x402-health first. If facilitator.up is false and freeTier.active is true, call Group B without PAYMENT-SIGNATURE. While payments are down, Desk, Network and bridge checks return the last paid answer marked stale:true with its asOf, for up to 10 minutes; after that 503 with Retry-After. Check stale and asOf before acting. A conversion still answers 503. Simple lookups stay free.
- One source is 0.01 USDC, amount 10000. Stablecoin FX is 0.01 USDC, amount 10000. Desk, Network, and Convert Check are 0.02 USDC, amount 20000. Asset keeta_amnkge74xitii5dsobstldatv3irmyimujfjotftx7plaaaseam4bntb7wnna. Network keeta:21378. Pay to keeta_aabz6zxbs2n4r7iiobclndobrnowxdf4pjrb5lwe6bvpeo564bot6krjbrsbbvy. Scheme exact.
- Sign with https://keeta.ai/skills/x402-payments/SKILL.md. Do not publish that send yourself. The facilitator at https://x402.keespecs.xyz (fallback https://facilitator.x402.keeta.com). You don't call it; just retry with PAYMENT-SIGNATURE. Check /api/x402-health first. settles it and pays the network fee.
- Retry the same URL and the same query with a PAYMENT-SIGNATURE header. JSON is returned only after settlement.
- A missing or malformed query returns 400 and is not charged.

## Do not

- Do not send a seed or a private key.
- Do not use a read as a way to send, bridge, pay a card, or pass KYC.

Catalogue: https://keespecs.xyz/apis
Skills: https://keespecs.xyz/skills
Sending, bridging, banks, cards, and identity: https://keeta.ai/llms.txt