# Brük Agent API

Project index, for any device or agent: https://bruk-agent-api.fly.dev/projects.txt
This API is one project. It is not the visual site, and it does not answer Weighmaster questions.

> Verified XRP Ledger answers for AI agents. Each answer includes proof (ledger index, validation status, sources) and an explicit list of what is not known. Pay per call with x402 (XRP or RLUSD on the XRP Ledger; USDC on Base when enabled); no account or API key.

Payment network: xrpl:0 (mainnet). Data network: XRP Ledger mainnet.
Pay with: XRP on xrpl:0; RLUSD on xrpl:0 (issuer rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De); USDC on eip155:8453.
Bad input and ledger outages are never charged.
MCP: remote server at https://bruk-agent-api.fly.dev/mcp (Streamable HTTP). Paid tools follow the x402 MCP transport (payment in params._meta['x402/payment']).
The 402 response lists several payment options (USDC on Base first). XRP Ledger clients select the xrpl:0 option by network, e.g. x402_requests(wallet, network_filter="xrpl:0"). payment-watch also accepts a JSON body.

## Paid services
- [ledger_pulse](https://bruk-agent-api.fly.dev/v1/pulse) (GET): XRP Ledger network health right now: latest validated ledger, close time, transactions and payments in it, fee levels, load, and rolling averages cross-checked against a direct ledger read. Useful before submitting XRP Ledger transactions or when reporting current network conditions. Price $0.001 in RLUSD or USDC, or 800 XRP drops.
- [payment_check](https://bruk-agent-api.fly.dev/v1/payment-check) (GET): Verifies that an XRP Ledger payment settled as expected: validation, result code, destination, destination tag, currency, issuer, and the amount actually delivered, which exposes partial-payment tricks. Useful when confirming that a customer or counterparty really paid. Price $0.01 in RLUSD or USDC, or 7750 XRP drops.
- [issuer_check](https://bruk-agent-api.fly.dev/v1/issuer-check) (GET): Checks whether an XRP Ledger token issuer is who it claims to be: two-way domain verification (on-ledger Domain field against the domain's xrp-ledger.toml), tokens issued and outstanding, and control flags such as freeze, clawback, blackholed, and multisign. Useful before accepting or holding a token. Price $0.01 in RLUSD or USDC, or 7750 XRP drops.
- [token_check](https://bruk-agent-api.fly.dev/v1/token-check) (GET): Identifies one XRP Ledger token from the validated ledger: a trust-line token (currency code plus issuer) or a multi-purpose token (48-hex issuance id). Reports the type, issuer domain check, supply, and controls that can freeze, lock, claw back, or restrict holders. Issuer-written metadata is quoted and is not treated as fact; a missing asset class is reported missing. Does not check other chains, and does not rate legal backing or solvency. Useful before accepting an MPT or any other token. Price $0.01 in RLUSD or USDC, or 7750 XRP drops.
- [large_payments](https://bruk-agent-api.fly.dev/v1/large-payments) (GET): Lists large XRP Ledger payments (50,000+ XRP or major stablecoins) in a recent window of up to 120 minutes, each independently re-checked on the ledger, with an explicit note when the window is not fully covered. Useful for market and liquidity monitoring. Price $0.02 in RLUSD or USDC, or 15500 XRP drops.
- [send_check](https://bruk-agent-api.fly.dev/v1/send-check) (GET): Pre-send check for an XRP Ledger payment: whether the destination is activated, requires a destination tag, blocks or pre-approves senders, can hold the token (trust line, or MPT opt-in and issuer approval), is blackholed, and whether the source can afford it. For a multi-purpose token, pass mpt_issuance_id instead of currency and issuer. Returns ok_to_send, send_with_caution, or will_fail with reasons. Useful before any irreversible XRP Ledger payment. Price $0.005 in RLUSD or USDC, or 3850 XRP drops.
- [receipt_card](https://bruk-agent-api.fly.dev/v1/receipt-card) (GET): Verified payment receipt image (1200x675 PNG) for an XRP Ledger payment, drawn only from the validated ledger: delivered amount, sender, recipient, destination tag, ledger, close time, result, optional expectation checks, and a QR code to the public explorer. Only final outcomes are drawn; not-found or unvalidated transactions are not charged. Useful for showing a person proof that a payment arrived. Price $0.02 in RLUSD or USDC, or 15500 XRP drops.
- [ledger_moment](https://bruk-agent-api.fly.dev/v1/ledger-moment) (GET): Ledger moment image (1200x675 PNG): one validated XRP Ledger ledger drawn as one tile per transaction in ledger order, colored by type (payments, DEX offers, trust lines, AMM, NFTs, other), failed transactions hollow, with counts, fees burned, XRP supply, and the ledger hash. Latest validated ledger by default. Useful for posts, reports, and newsletters about network activity. Price $0.02 in RLUSD or USDC, or 15500 XRP drops.
- [payment_watch](https://bruk-agent-api.fly.dev/v1/payment-watch) (POST): Payment arrival alert: watches an XRP Ledger address for up to 24 hours and POSTs a signed webhook when a matching payment is final (validated, tesSUCCESS, delivered amount checked), or a watch.expired event if none arrives. Payments that land during restarts are still caught. Useful when waiting on an incoming payment without polling. Price $0.05 in RLUSD or USDC, or 38500 XRP drops.

## Token types (free guide, not a live check)
Brük checks the XRP Ledger only. A ticker is not an identity.
- Trust-line token: currency code plus issuer address. Call token_check. Older issued currencies, including RLUSD, are this type.
- Multi-purpose token (MPT): 48-hex issuance id, not a ticker. This is the XRP Ledger's newer fungible token, with room for the issuer to write an asset class such as real estate, commodity, or stock. Call token_check before holding one, and send_check with mpt_issuance_id before sending. A written class is the issuer's label. Trading MPTs on the XRP Ledger exchange is not implemented.
- NFT: unique, not a balance. Brük does not check NFTs.
- XRP: no issuer. Not a token. Use ledger_pulse or send_check.
- Other chains: Stellar, Hedera, and Solana have their own token types. Ondo is an issuer, not a chain; its XRP Ledger tokens are checked like any other token here. Brük does not read those other ledgers.
- [Token types as JSON](https://bruk-agent-api.fly.dev/v1/token-types)

## Learn (free to quote and link, with credit)
- [Brük live](https://brukledger.com/): Brük: the live XRP Ledger portrayed as art, a real-time visual instrument for people.
- [A Flight Through the Ledger](https://brukledger.com/film) (5:44): A cinematic introduction to the XRP Ledger: from a single address to a connected world. Chapters: 00:00 The Address; 00:49 The Account; 01:42 The Transaction; 03:02 The Lift.
- [Film transcript](https://brukledger.com/assets/film-transcript.txt) and [captions](https://brukledger.com/assets/film-captions.vtt)
- Credit line: Brük, A Flight Through the Ledger, brukledger.com/film
- [Learn resources as JSON](https://bruk-agent-api.fly.dev/v1/learn)

## Weighmaster (separate tester, not a Brük answer)
Weighmaster publishes test results for XRP Ledger-paid AI services, including Brük. Read https://x402-seal-proto.fly.dev/llms.txt before summarizing those results. A grade of not_verified can mean the wallet is young even when a paid call passed. Do not answer Weighmaster questions from this API.

## Free
- One real answer per visitor per day on the priced checks, then the price. A payment watch stays paid. The Weighmaster handshake still receives the price notice.
- [Free daily send check](https://bruk-agent-api.fly.dev/v1/free/send-check?destination=rEXAMPLE): one per visitor per day; verdict, blockers, and cautions before you send. Also the MCP tool free_send_check.
- [Samples](https://bruk-agent-api.fly.dev/v1/sample/pulse): /v1/sample/{pulse|payment-check|issuer-check|large-payments|send-check|receipt-card|ledger-moment}}
- [Watch status](https://bruk-agent-api.fly.dev/v1/watch/{watch_id})
- [x402 catalog](https://bruk-agent-api.fly.dev/.well-known/x402)
- [OpenAPI](https://bruk-agent-api.fly.dev/openapi.json)