Citrea Claw Skill
Apps & Automationcitrea-claw-skillCitrea Claw Skill is an Agent Skill for apps & automation published in the LeoYeAI/openclaw-master-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
A CLI tool and OpenClaw skill for monitoring the Citrea Bitcoin L2 ecosystem
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/LeoYeAI/openclaw-master-skills/blob/HEAD/skills/citrea-claw-skill/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/citrea-claw-skill, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
citrea-claw-skill
Monitor the Citrea Bitcoin L2 ecosystem. Track DEX pools, liquidity, arbitrage opportunities, token prices, and wallet balances — all sourced directly from Citrea mainnet with no third-party APIs.
Commands
balance
Check cBTC and token balances for a wallet address with USD values.
- Usage:
balance <address> - Example:
balance 0xYourAddress
price
Get the current USD price for a token from RedStone on-chain oracles.
- Usage:
price <token> - Example:
price wcBTC - Tokens: wcBTC, ctUSD, USDC.e, USDT.e, WBTC.e, JUSD
pool:price
Show the implied price of a token pair from each DEX side by side, with oracle deviation.
- Usage:
pool:price <tokenA> <tokenB> - Example:
pool:price wcBTC USDC.e
pools:recent
List all new pools created in the last N hours across JuiceSwap and Satsuma.
- Usage:
pools:recent [hours] - Example:
pools:recent 24
pools:latest
Show the most recently created pool on each DEX.
- Usage:
pools:latest
pools:monitor
Watch for new pools in real time. Sends a Telegram alert whenever a new pool is created on any supported DEX.
- Usage:
pools:monitor
pool:liquidity
Show TVL and token reserves for a pool. Accepts a pool address, token pair, or single token.
- Usage:
pool:liquidity <poolAddr|tokenA tokenB|token> - Examples:
pool:liquidity wcBTC USDC.epool:liquidity 0xPoolAddresspool:liquidity wcBTC
arb:check
Check a specific token pair for arbitrage opportunities across JuiceSwap and Satsuma.
- Usage:
arb:check <tokenA> <tokenB> - Example:
arb:check wcBTC USDC.e
arb:scan
Scan all token pairs for arbitrage opportunities in a single pass. Shows price spread, estimated profit, gas cost, and net profit after fees.
- Usage:
arb:scan
arb:monitor
Continuously monitor all token pairs for arbitrage opportunities. Sends a Telegram alert when a profitable opportunity is detected above the configured threshold.
- Usage:
arb:monitor
txns
Show recent token transfer activity for a wallet address.
- Usage:
txns <address> [hours] - Example:
txns 0xYourAddress 24
Supported Tokens
| Symbol | Description |
|---|---|
| wcBTC | Wrapped Citrea Bitcoin |
| ctUSD | Citrea USD stablecoin |
| USDC.e | Bridged USDC (LayerZero) |
| USDT.e | Bridged USDT (LayerZero) |
| WBTC.e | Bridged Wrapped Bitcoin (LayerZero) |
| JUSD | BTC-backed stablecoin (JuiceDollar) |
Supported DEXes
| DEX | Type | Fee Tiers |
|---|---|---|
| JuiceSwap | Uniswap V3 | 0.05%, 0.30%, 1.00% |
| Satsuma | Algebra | Dynamic per pool |
Configuration
Set these in your .env file:
| Variable | Description | Default |
|---|---|---|
TELEGRAM_BOT_TOKEN | Bot token from @BotFather | — |
TELEGRAM_CHAT_ID | Your chat ID from @userinfobot | — |
ARB_ALERT_THRESHOLD_BPS | Minimum profit to trigger arb alert (basis points) | 50 |
ARB_MONITOR_INTERVAL_SEC | Seconds between arb scans | 15 |
Notes
- All data sourced directly from Citrea mainnet — no third-party APIs
- Prices from RedStone push oracles deployed on Citrea
- Arb detection is indicative only — always verify on-chain before executing
- JuiceSwap JUSD pairs use svJUSD internally — handled transparently
- RPC:
https://rpc.mainnet.citrea.xyz