# OwlGate

> OwlGate (https://owlgate.xyz) is a trading terminal for TapeOut mining rigs. On X Layer (chain 196) it runs the market for TapeOut Rig Bridge vouchers: list, buy, offer and sell on Seaport 1.6. OwlGate holds no keys and no funds. This file tells AI agents how to read the market and get UNSIGNED transactions that your own wallet signs within its own limits.

Facts, not advice. Prices and estimates change every block. Nothing here is a promise of returns.

## What a voucher is

- Contract `0x9cfc959cd42b2e1d39a0d850c528210e818ae520` on X Layer ("TapeOut Rig", ERC-721). It is an ERC1967 UUPS proxy: TapeOut can upgrade it.
- Each voucher stands for one rig locked in the TapeOut Rig Bridge on BNB Chain. The rig keeps mining BEM on BNB; rewards go to the voucher holder. Redeeming returns the rig (fee in OKB, see `redeemFeeOkb`).

## Market data (GET, JSON, no key)

- [Market](https://api.owlgate.xyz/xl/market): every voucher with its rig (power, mining), `bemPerDay`, `unclaimedBem`, cheapest `ask` (OKB), `bestOffer` (WOKB), `paybackDays` (estimate), top collection offers, OKB and BEM USD prices with their sources, fee terms.
- [Order book](https://api.owlgate.xyz/bids?chain=196): every open signed order (kind `list` | `offer` | `coll`), with the full Seaport order and signature.
- [Your orders](https://api.owlgate.xyz/bids?offerer=0xYOUR_WALLET): all chains; X Layer orders have `chain: 196`.
- [Fee-free slots](https://api.owlgate.xyz/free?wallet=0xYOUR_WALLET): the first 5 orders of each wallet carry no fee.
- [Config](https://api.owlgate.xyz/config.json): `bidsEnabled`, fee terms, contract addresses. If `bidsEnabled` is false, do not trade.

## Transactions (GET, returns steps, never signs)

Every answer is `{chainId: 196, from, steps: [...], summary}`. Run the steps in order:
- `{kind: "tx", to, data, value}`: send this transaction from `from` on chain 196 (value in wei, hex).
- `{kind: "sign", typedData}`: sign with `eth_signTypedData_v4` (EIP-712, Seaport 1.6 domain, chainId 196). Signing is free.
- `{kind: "post", url, body}`: POST `body` with `signature` set to the signature from the sign step.

Fills are simulated with `eth_call` from your wallet before we answer. HTTP 409 means it would revert: do not send.

- Buy a listing: `GET https://api.owlgate.xyz/xl/tx/buy?hash=ORDER_HASH&from=0xYOU`. One tx, value = price in OKB.
- Sell a voucher you hold into the best offer: `GET https://api.owlgate.xyz/xl/tx/sell?v=VOUCHER_ID&from=0xYOU` (optional `&hash=` to pick an offer). Steps: approve this one voucher (only if needed), then accept. When an approval step is present, simulate the accept step yourself after the approval. A collection-offer accept must be sent within 1 hour.
- List, offer, or offer on any voucher: `GET https://api.owlgate.xyz/xl/order/build?kind=list|offer|coll&from=0xYOU&v=VOUCHER_ID&price=1.5&days=1|3|7` (`v` not needed for `coll`). Steps: approve or wrap OKB to WOKB if needed, sign, post.
- Cancel: `GET https://api.owlgate.xyz/xl/tx/cancel?hash=ORDER_HASH&from=0xYOU`, or `&all=1` to cancel every order you signed on X Layer.

## Terms

- Settlement: Seaport 1.6 `0x0000000000000068f116a894984e2db1123eb395`. Listings are paid in native OKB. Offers use WOKB `0xe538905cf8410324e03a5a23c1c177a474d59b2b` and stay in the bidder's wallet until a holder accepts.
- Fee: 0.75% to `0x58f341ebf80ab52d7650750119e8641cfbc8c018`, paid by the seller out of the price. The first 5 orders of each wallet are fee-free. Price range 0.01 to 500 OKB. Expiry 1, 3 or 7 days.
- Approvals are exact: one voucher at a time, and WOKB only up to the sum of your open offers.
- Rate limit per IP. Read endpoints are cached up to 15 to 60 seconds.

## Optional

- [Site](https://owlgate.xyz/#xl): the same market for people.
- [Telegram bot](https://t.me/owlgate_bot): alerts.