Skip to content

bankr.md

Latest commit

 

History

History
188 lines (129 loc) · 6.86 KB

bankr.md

File metadata and controls

188 lines (129 loc) · 6.86 KB
Raw

Zerion + Bankr: Research → Execute

Purpose: Pair Zerion CLI's interpreted, multi-chain wallet data with Bankr's natural-language execution layer so an AI agent can go from on-chain insight to signed transaction in one workflow.

Architecture: Zerion CLI is the research layer (interpreted wallet data across 41+ chains, works on any address) and has its own swap/bridge for direct execution. This skill complements that by routing actions through Bankr to reach surfaces Zerion doesn't natively cover — Hyperliquid perps, Polymarket, scheduled automation (DCA, limit, stop-loss), social-handle transfers, NFT trades, Base token deploys, and x402 paid APIs. One Bankr wallet covers the full action surface.

Key Commands

Zerion (research used here):

  • zerion analyze <addr> — full portfolio, positions, transactions, PnL
  • zerion portfolio <addr> — USD value + chain distribution
  • zerion positions <addr> — token + DeFi positions
  • zerion pnl <addr> — realized & unrealized P&L
  • zerion history <addr> — interpreted transaction history

Bankr (execution):

  • bankr wallet portfolio — Bankr wallet balances
  • bankr wallet transfer --to <addr> --token <sym> --amount <n> — direct send (ENS supported)
  • bankr agent prompt "<natural language>" — swaps, leverage, Polymarket, NFTs, deploys, automation
  • bankr tokens search <q> / bankr tokens info <sym> — token discovery

Requirements

# Zerion CLI (read layer)
npm install -g zerion-cli
export ZERION_API_KEY="zk_..."     # or pass --x402 to pay $0.01 USDC per request

# Bankr CLI (execution layer)
bun install -g @bankr/cli           # or: npm install -g @bankr/cli
bankr login email <you@example.com>
# verify OTP with: --accept-terms --agent-api --read-write --key-name "Zerion+Bankr"

Capture the Bankr wallet address once — every workflow below feeds it to Zerion:

BANKR_ADDR=$(bankr whoami --json | jq -r '.address')

Workflows (priority order, highest-value first)

1. Automation: DCA, limit orders, stop loss

Use Zerion PnL to set thresholds, Bankr to schedule the strategy.

zerion pnl $BANKR_ADDR

bankr agent prompt "DCA \$100 into ETH every Friday"
bankr agent prompt "Buy ETH if price drops to \$3000"
bankr agent prompt "Stop loss on my ETH at -20%"

2. Copy-trade a profitable wallet

Zerion's interpreted history + PnL on any address makes this practical.

WHALE=0xWHALE_ADDRESS
zerion pnl $WHALE
zerion history $WHALE

bankr agent prompt "Buy \$50 of <token> on <chain>"

3. Hyperliquid leverage hedging

Bankr's unique Hyperliquid + Avantis integration (up to 50x crypto, 100x forex).

zerion positions $BANKR_ADDR        # see spot exposure

bankr agent prompt "Short \$500 of ETH on Hyperliquid with 5x leverage"
bankr agent prompt "Open 10x long on BTC with stop loss at 45000"
bankr agent prompt "Show my Hyperliquid positions"

4. Polymarket prediction-market bets

Size bets against actual free balance.

zerion positions $BANKR_ADDR

bankr agent prompt "What are the odds on <market topic>?"
bankr agent prompt "Bet \$10 on Yes for <market>"
bankr agent prompt "Show my Polymarket positions"

5. Advanced: x402 paid APIs, arbitrary calldata, web browse, LLM gateway

Unlocks agent power-features.

zerion analyze $BANKR_ADDR          # confirm wallet readiness for paid calls / arb tx

bankr agent prompt "Find x402 endpoints for sentiment analysis"
bankr agent prompt "Call the weather endpoint on x402"
bankr agent prompt "Submit this transaction: {to:0x..., data:0x..., value:0, chainId:8453}"
bankr agent prompt "Browse coingecko.com and get the top trending tokens"

bankr llm credits add 25            # top up gateway credits from Bankr wallet
bankr llm models                    # list Claude / GPT / Gemini available via gateway

6. Deploy a token on Base

Bankr deploys ERC20 tokens on Base only.

zerion portfolio $BANKR_ADDR        # confirm ETH on Base for gas + deployment funds

bankr agent prompt "Deploy a token called MoonShot with symbol MOON on Base"
bankr agent prompt "Claim my creator fees for MOON"

7. Spot trade informed by portfolio analysis

zerion analyze $BANKR_ADDR

bankr agent prompt "Buy \$100 of ETH on Base"
bankr agent prompt "Swap 50 USDC for PEPE on Base"
bankr agent prompt "Sell 50% of my PEPE"

8. Cross-chain rebalance

Zerion's per-chain distribution is sharper than Bankr's single-chain views.

zerion portfolio $BANKR_ADDR        # see chain-by-chain allocation

bankr agent prompt "Bridge 200 USDC from Polygon to Base"
bankr agent prompt "Swap 0.5 ETH for USDC on Base"

9. Transfers (ENS + social handles)

Bankr resolves vitalik.eth, .base.eth, .cb.id directly; the agent also handles Twitter / Farcaster handles.

zerion analyze $BANKR_ADDR          # confirm balance pre-send

bankr wallet transfer --to vitalik.eth --token USDC --amount 50 --chain base
bankr agent prompt "Send 0.1 ETH to @friend on Twitter"

10. NFT browse, buy, transfer

zerion analyze $BANKR_ADDR          # see current NFT holdings

bankr agent prompt "Show Pudgy Penguin floor price"
bankr agent prompt "Buy the cheapest Pudgy Penguin"
bankr agent prompt "Show my NFTs"

11. Market research before any trade

Combine Bankr token intel with Zerion whale activity.

bankr tokens search PEPE
bankr tokens info USDC
bankr agent prompt "Technical analysis on ETH"

zerion history 0xWHALE_HOLDING_TARGET_TOKEN

Common Blockers

  • Bankr key is read-only — re-login with --read-write --agent-api or every write returns 403
  • Wallet-level safety limits — Bankr defaults to $500 per tx and $500 / 24h at bankr.bot → Security; raise before large rebalances or deploys
  • Wrong chain in prompt — always say on Base / on Solana / on Polygon, or trades may pick the wrong network
  • Execution path — this skill routes every action through Bankr so one wallet covers everything (Hyperliquid, Polymarket, automation, etc.). Zerion's native zerion swap / zerion bridge work great standalone if you'd rather sign there — see the capabilities/trading.md skill
  • Rate limits — Bankr ships 100 msg/day standard, 1,000/day with Bankr Club; Zerion API has its own per-key tier
  • LLM credits are separate from the trading wallet — bankr llm credits add <n> before using the gateway
  • Polymarket lives on Polygon — Bankr handles routing, but ensure the Bankr wallet has USDC + a little MATIC for gas
  • Hyperliquid is its own L1 — funded via Bankr's bridge; first leverage prompt may take a moment to provision

Related Skills

  • capabilities/analyze.md — deeper coverage of zerion analyze for any address
  • zerion — base Zerion CLI reference (endpoints, x402 access)
  • capabilities/trading.md — execution via Zerion's own swap/bridge (uses a Zerion wallet — not used here)