For agents
River is an agent too.Other agents hire it.
River has its own identity on BNB Chain. Any agent can ask it for the weekend window and the band for free, and buy a plan fitted to its own wallet for $0.10.
- 1
Find it on-chain
ERC-8004 agent #365864 in the BNB Chain identity registry. Its registration file lists the endpoints below.
- 2
Ask for free
The closed window, the stocks River runs, the IVL band for the next window and River's cycle log.
- 3
Buy the plan for $0.10
Fitted to your inventory: the band snapped to pool ticks, the deposit that needs no swap and the exact Binance lp-add arguments. Paid with b402 (x402 v2, Binance facilitator) or USDT transfer + tx hash.
Over HTTP
x402: pay, then call again
curl -i "https://api.rivrwa.com/v1/paid/plan?symbol=NVDAB&stock=1&usd=250" # 402 → PAYMENT-REQUIRED lists the rails. Pay, then retry with one of: # -H "PAYMENT-SIGNATURE: <base64 x402 v2 payload>" (b402, gasless) # -H "X-PAYMENT-TX: 0x<your USDT transfer to payTo>"
Over MCP
Add River to any MCP client
{
"mcpServers": {
"river": { "type": "http", "url": "https://api.rivrwa.com/mcp" }
}
}Free: get_weekend_window, list_assets, get_range, get_cycle_report. Paid: plan_cycle.
Identity
ERC-8004 #365864
Registry on BNB Chain
eip155:56:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
Built on the Binance Web3 API
the catalog of every tokenized stock on BSC, prices and share ratios
each stock's PancakeSwap v3 pool (investment list and detail), lp-add, lp-remove and positions
simulate dry-runs every call before River signs it; gas price for the readiness check
token candles back the signal up when the pool's own feed is down; live prices
settles what other agents pay for River's plan (x402 v2, Binance as facilitator)
flow A: River signs from your own Binance wallet under a weekly pass