---
name: keespecs
description: Username and the KTA price are free. Other sources are 0.01 USDC. Stablecoin FX is 0.01 USDC. Desk, Network, and Convert Check are 0.02 USDC. Pages are free. Choose the read at /skills first. Do not use this to send, bridge, or pass identity.
---

# KeeSpecs

The page at https://keespecs.xyz/ is free. Prices and parameters are at https://keespecs.xyz/apis. Which read to buy is at https://keespecs.xyz/skills. Sending and bridging start at https://keeta.ai/llms.txt.

## Buy one read

1. GET the URL below with no payment. Include the query it requires.
2. Read the 402 body and the PAYMENT-REQUIRED header.
3. Pay with the exact scheme on keeta:21378, using [x402 payments on Keeta](https://keeta.ai/skills/x402-payments/SKILL.md).
4. Retry the same GET, including the same query, with the PAYMENT-SIGNATURE header. The JSON is returned only after the facilitator settles.

| Term | Value |
| --- | --- |
| Price | 0.01 USDC for one source. 0.01 USDC for Stablecoin FX. 0.02 USDC for Desk, Network, and Convert Check |
| Amount | 10000, or 20000 for a join |
| Asset | keeta_amnkge74xitii5dsobstldatv3irmyimujfjotftx7plaaaseam4bntb7wnna |
| Network | keeta:21378 |
| Pay to | keeta_aabz6zxbs2n4r7iiobclndobrnowxdf4pjrb5lwe6bvpeo564bot6krjbrsbbvy |
| Scheme | exact |
| Facilitator | 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. |

| Read | Request | Returns |
| --- | --- | --- |
| Convert Check | GET https://keespecs.xyz/api/convert-check?kind=convert&from={from}&to={to}&amount={amount}. GET https://keespecs.xyz/api/convert-check?kind=bridge&token={token}&toChain={toChain}&amount={amount} | 0.02 USDC. go, caution, or no-go before a conversion or a bridge. kind is convert or bridge. A parameter from the other kind returns 400 and is not charged. Each input is shown with its rule. Not a quote or a guarantee. |
| Stablecoin FX | GET https://keespecs.xyz/api/stablecoin-fx?currency=&from=&to= | 0.01 USDC. Peg check for Keeta's $K/$KB same-currency anchor (mainnet, thin). Only $KB→$K is offered today. Not an FX rate or a quote. reason is direction_not_offered when the pair is not listed in serviceMetadata, no_ratio_returned when it is listed but the price call returned no ratio, and upstream_error when the anchor call fails or times out. USDC and EURC are not pairs on this anchor. |
| x402 health | GET https://keespecs.xyz/api/x402-health | Free. Whether the Keeta x402 facilitator answers right now. If it is down, paid reads cannot settle. |
| Regime | GET https://keespecs.xyz/api/regime | 0.01 USDC. The deepest Base pool for KTA over the last hour, and whether Keeta's own rail is quiet or slow. The score is not a forecast and not a social mood. |
| Status | GET https://keespecs.xyz/api/status | 0.01 USDC. Three checks for this minute. The ledger produced transactions or it did not. Settlement's median representative p95 is within 5 seconds across a 15-minute window, or it is not. Fewer than 3 representatives is unknown. The price marks agree within 1% of their median, or they do not. Each line is pass, fail, or unknown. There is no score. |
| Price check | GET https://keespecs.xyz/api/prices | 0.01 USDC. The deepest Base pool, Keeta's pricing anchor, and the CoinGecko keeta price are the marks. agree is true when at least two of them answered and each is within 1% of their median. keeta-fx is published as tradable and is not part of agree. No blended price. Keeta USDC is treated as $1. |
| Price crossings | GET https://keespecs.xyz/api/price-crossings?since= | 0.01 USDC. When the Base pool, Keeta's pricing anchor, Keeta's FX anchor, and CoinGecko crossed the 1% line, or came back inside it. moved may be keeta-fx. Samples that stay on the same side are omitted. The first sample is a baseline. |
| Username | GET https://keespecs.xyz/api/username?name=&account= | Free. A keeta.xyz name to its Keeta address, or an address back to its name. Pass both to check that they still point at each other. Includes the upstream response hash and a ledger check on a single lookup. Not an on-chain proof. |
| Bridge route | GET https://keespecs.xyz/api/bridge-route?from=&to=&token= | 0.01 USDC. Which of LayerZero, Bridge.xyz, or Keeta's Base bridge published a one-hop path for a token between two chains. canMove is false when none did. Not a quote, not a fee, and not a transfer. |
| Choose a rail | GET https://keespecs.xyz/api/corridors/choose?country=&currency=&location=&direction=&residency=&kind= | 0.01 USDC. The one eligible local rail with the lowest published fixed fee, plus the rails set aside and why. Default direction is out. Basis points are returned and not used to rank, because the fee unit is not named. Not a quote. |
| Changes | GET https://keespecs.xyz/api/changes?since= | 0.01 USDC. What moved since a date: corridor rails and fees, the KTA dollar price, and samples of the live rate and settlement time. The first copy of each series is a baseline. verification.designator is compared. |
| Corridor changes | GET https://keespecs.xyz/api/corridors/changes?since= | 0.01 USDC. Rails added or removed, and published fees that changed, since KeeSpecs' previous copy of provider metadata. The first copy is a baseline and lists no changes. verification.designator is compared. |
| Desk | GET https://keespecs.xyz/api/desk | 0.02 USDC. One market call: the KTA dollar price, supply of KTA, USDC, EURC, and cbBTC, the send ranks, and the AlpacaDEX pools with 24-hour volume. The price alone is free. Supply, movers, and Alpaca stay separate. Not a forecast. |
| Network | GET https://keespecs.xyz/api/network | 0.02 USDC. Live throughput and settlement time in one call. last60sTps is the live rate. lifetimeTps is the average since 22 Sep 2025. Settlement is a 15-minute window across representatives, in milliseconds. Pulse and settlement remain separate 0.01 calls. |
| Corridor index | GET https://keespecs.xyz/api/corridors/index | Free. Every published bank and card location with its currency, directions, rails, and providers. No fees and no recipient fields. |
| Corridors | GET https://keespecs.xyz/api/corridors?country=&currency=&location=&direction=&rail=&kind=&residency= | 0.01 USDC. Where money can move between Keeta and a bank or card: provider, rail, recipient fields, exclusions, and the fee that provider published. Not a quote and not an FX rate. Pass a country, currency, or location. |
| Directory | GET https://keespecs.xyz/api/directory | Free. Every token in the Keeta currency map, with the supply the explorer reports. Token amounts, not prices. |
| Ecosystem | GET https://keespecs.xyz/api/ecosystem | Free. The KeeSpecs app registry: verified apps, plus the Keeta products and companies named on keeta.com. Not a ranking. |
| Providers | GET https://keespecs.xyz/api/providers | Free. Keeta's published anchor providers: service, address, and what their metadata says they connect. Last movement only if that address is in the current activity page. Not a quote. |
| Anchors | GET https://keespecs.xyz/api/anchors | 0.01 USDC. The newest movement of the Base anchor or the Bivo anchor in one activity page, and the median block fee. An empty list is not an outage. |
| Alpaca | GET https://keespecs.xyz/api/alpaca | 0.01 USDC. AlpacaDEX pools that had 24-hour volume, with price and market cap in KTA. Not a 12-hour figure, not dollars, and not operated by Keeta. |
| Movers | GET https://keespecs.xyz/api/movers | 0.01 USDC. Community tokens and official stablecoins ranked by how many times they were sent. covers12h is true only when the activity page reaches back 12 hours. Not dollar volume and not an exchange rate. |
| Price | GET https://keespecs.xyz/api/price | Free. Dollar price of the deepest Base pool for KTA, plus that pool's 1-hour and 24-hour change. If both pool publishers are rate-limited, Keeta's pricing anchor and then its FX anchor are used, and the changes are omitted. An old price is not returned. Not the price check, and not a forecast. |
| Supply | GET https://keespecs.xyz/api/supply | Free. On-chain supply of KTA, USDC, EURC, and cbBTC in one call. Token amounts, not dollar prices. |
| Settlement | GET https://keespecs.xyz/api/settlement | 0.01 USDC. Median and 95th percentile of settlement time, in milliseconds, across representatives in a rolling 15-minute window. The lifetime histogram from one representative is not used. Fewer than 3 representatives with 100 samples is unknown, not a failure. |
| Representatives | GET https://keespecs.xyz/api/representatives | Free. Representatives that currently hold voting weight, heaviest first. share is that row's fraction of the total. label is a short name when one is known. Zero-weight addresses are omitted. |
| Permissions | GET https://keespecs.xyz/api/permissions?account= | 0.01 USDC. Who may act on the account. Flags are names such as ACCESS and ADMIN. This call does not change them. |
| Token check | GET https://keespecs.xyz/api/token/check?token=&symbol= | 0.01 USDC. Is this the real token? Every token with that code or address, which one is official, and warnings such as same code as an official token. Not an audit. |
| Token search | GET https://keespecs.xyz/api/token/search?q=&limit= | Free. Ticker, name, or description to the token addresses that match. Official addresses come first. Not supply and not a warning list. |
| Token | GET https://keespecs.xyz/api/token?token= | Free. Name, code, decimals, and supply. Use this before scaling a base-unit amount. The token is an address, not a ticker. |
| Block | GET https://keespecs.xyz/api/block?hash= | Free. One block by its 64-character hash. No signatures. Operation amounts are base units. |
| Outbox | GET https://keespecs.xyz/api/outbox?account= | 0.01 USDC. Latest blocks this address itself published. Amounts are base units. Up to 8. |
| Activity | GET https://keespecs.xyz/api/activity?account= | 0.01 USDC. Latest confirmed events that touched the address, including ones it did not sign. Amounts are base units. Up to 8. |
| Account | GET https://keespecs.xyz/api/account?account= | 0.01 USDC. Head block, height, chosen representative, the name the account published, and its balances. label is a short name when KeeSpecs knows the address. |
| Portfolio | GET https://keespecs.xyz/api/portfolio?account= | 0.01 USDC. Every token that address holds, up to 40. A missing name does not mean the balance is zero. |
| Balance | GET https://keespecs.xyz/api/balance?account=&token= | Free. One token on one address. amountBase is the ledger integer. amount is that integer scaled by decimals. label names the account when KeeSpecs knows it. |
| Pulse | GET https://keespecs.xyz/api/pulse | 0.01 USDC. Ledger totals, tx/s over the last minute, blocks per second, the busiest second, the median gap between blocks, and the latest blocks. lifetimeTps is the average since 22 Sep 2025, not the live rate. |
| Address check | GET https://keespecs.xyz/api/address-check?account= | 0.01 USDC. Whether a Keeta address has at least one block, its type, balances, and a score from 0 to 100. The four parts are age (40), block count (30), counterparties (20), and a keeta.xyz username (10). The formula is at /docs/address-check#score. Not proof of personhood. The name is from keeta.xyz, not the ledger. |
| Storage quotas | GET https://keespecs.xyz/api/storage-quotas | 0.01 USDC. Keeta storage limits from storage-area1: max object size, objects and bytes per user, searchable fields, and the anchor account. live is false when served from cache. Sizes are bytes (10 MiB per object, 100 MiB per user). |
| Keeta settlement time | GET https://keespecs.xyz/api/bridge-speed?window=&direction=&asset= | 0.01 USDC. How fast and how reliably transfers move into and out of Keeta. window is 1h, 24h, or 7d. direction is in, out, or all. asset is an optional keeta_ token. timing_label is Keeta settlement time. Measured on Keeta only. Does not include time spent on the Corridor chain. timing_method same_staple_amount_token is an internal hop: median_ms and p95_ms, and median_seconds and p95_seconds to one decimal. It is not full settlement. score is null, label is unknown, and reason is settlement_not_observable. Fewer than 20 transfers is bridge_unknown. If no interval can be measured, reason is timing_not_observable. Not a guarantee of future transfer times. |
| Persist check | GET https://keespecs.xyz/api/persist-check?account= | 0.02 USDC. ready, caution, or blocked before storing data on Keeta, from the storage quotas, the account, its permissions, and the status checks. Reasons and the rule are included. A bad address returns 400 and is not charged. Not a guarantee. The rule is at /docs/persist-check#rule. |

Activity and outbox amounts are base units. Call the token read for decimals before showing a whole amount. A bad query returns 400 and is not charged.

Do not publish the payment yourself. The facilitator signs that send and pays the network fee.

Catalog: https://keespecs.xyz/.well-known/x402