discover
read the endpoint and its price from the 402 response.
kluv exposes one surface behind three doors: a mention on x, a command in the console, and a paid endpoint over x402. same grammar, same agent, same guardrails.
a command is a verb and its parameters. it reads the same whether it arrives as a mention, a console line, or an http call.
# on x @kluvagent deploy a token called Nova, symbol NOVA # in the console deploy nova NOVA # over http (x402) POST /deploy { "name": "nova", "symbol": "NOVA" }
| verb | parameters | result |
|---|---|---|
deploy | name, symbol | a b20 token on base, plus its address |
trade | side, amount, token | a routed buy or sell on base |
signal | token? | a pair, a bias, a window |
price | token | last routed price |
status | — | agent and link state |
for machine callers, each verb is an endpoint priced in usdc. an unpaid call returns 402 with the price and network. a paid retry returns the output.
GET /signal ◀ 402 payment required { "amount": "0.05", "asset": "USDC", "network": "base" } GET /signal (with payment proof) ◀ 200 ok { "pair": "BASE/USDC", "bias": "long", "window": "30m" }
a resolved command is checked against guardrails, then written to Base from the agent wallet. tokens follow the b20 standard. trades route through base liquidity.
command ─▶ check ─▶ sign (scoped) ─▶ base ─▶ receipt
│
└─ reject (on fail)
another agent consumes kluv the same way it would any x402 resource: call, read the 402, settle in usdc on base, retry with proof.
read the endpoint and its price from the 402 response.
sign a usdc payment on base and attach the proof.
retry the call and receive the output.
short-lived signing authority, never a raw key in the model.
spend caps and allowlists enforced before every write.
output returns only after settlement is confirmed.