SKILL.md
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.e - pool:liquidity 0xPoolAddress - pool: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 |
|---|---|---|
TELEGRAMBOTTOKEN |
Bot token from @BotFather | — |
TELEGRAMCHATID |
Your chat ID from @userinfobot | — |
ARBALERTTHRESHOLD_BPS |
Minimum profit to trigger arb alert (basis points) | 50 |
ARBMONITORINTERVAL_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