Nock documentation

Nock combines a genuinely helpful AI assistant with an on-chain swap engine. You describe what you want in plain language; Nock parses the intent, quotes live routes on Uniswap, and stages a transaction. Nothing executes until you sign it in your wallet.

It runs on Robinhood Chain — an Ethereum L2 where ETH is the gas token and Uniswap v2/v3/v4 are live — so you can trade tokenized equities and crypto side by side.

1. Say what you want. Type a trade or question — “buy NVDA with 0.1 ETH”, “swap 100 USDG to TSLA”, or “what is slippage?”.
2. Nock routes it. A parser turns your words into a structured intent; the engine queries Uniswap's QuoterV2 across direct and multi-hop paths and picks the best output.
3. You sign. Approve the token if needed, then confirm the swap. It executes from your address with 1% default slippage.

The chat understands amounts, tickers and direction. Some examples:

• > buy NVDA with 0.1 ETH
• > swap 250 USDG into TSLA
• > sell my AAPL for USDG
• > how does Robinhood Chain differ from Ethereum?

When a message is a trade, the swap card fills in automatically. When it's a question, Nock just answers.

The base currencies are ETH (native), WETH, and USDG (Global Dollar). On the receive side you can pick from the full Uniswap Robinhood token list — 100+ tokenized equities including NVDA, TSLA, AAPL, MSFT, AMZN, GOOGL, META, AMD, COIN and MSTR.

Nock is also a paid agent. Its best-route analysis is exposed at POST /api/agent behind the x402 payment protocol — the HTTP-402 “pay per call” standard for machine-to-machine payments. Other AI agents pay a micro-fee in USDG on Robinhood Chain to use it.

1. Call the endpoint with no payment → it returns 402 Payment Required with an accepts block: scheme exact, the USDG asset, price, and the payTo address.
2. Sign an EIP-3009 TransferWithAuthorization for that amount and retry with a base64 X-PAYMENT header.
3. Nock verifies the signature and returns the premium quote plus an X-PAYMENT-RESPONSE header.

# 1) discover the price
curl -i https://nock.app/api/agent
# → 402 { accepts: [{ scheme:"exact", asset:USDG, maxAmountRequired:"10000", … }] }

# 2) pay + call (X-PAYMENT = base64 signed EIP-3009 authorization)
curl -X POST https://nock.app/api/agent \
  -H "X-PAYMENT: <base64>" \
  -d '{"tokenIn":"ETH","tokenOut":"USDG","amount":"0.1"}'
# → 200 { paid:true, rate:"1 ETH ≈ 1,831 USDG", route:"WETH → USDG" }

Robinhood Chain mainnet, chain ID 4663. Addresses are from the official Uniswap deployment registry and cross-checked on Blockscout.

• Self-custodial. Nock never holds your funds. Swaps run from your wallet and require your signature.
• No secrets. Nock never asks for private keys or seed phrases and never needs them.
• You set the risk. Default slippage is 1%; you always see the route and estimated output before signing.
• Not financial advice. Nock is a tool, not an advisor. Trade responsibly.

More questions are answered on the home page FAQ. Ready to try it?