Arbitrage for Openclaw

A professional-grade toolkit for identifying, calculating, and validating cross-market price gaps while accounting for every dollar of friction.

ivangdavila
v1.0.0
Mar 17, 2026
0
1.2k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install arbitrage

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install arbitrage using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Arbitrage?

The Arbitrage skill is a specialized technical framework designed for Openclaw Skills users to evaluate price gaps, hedges, surebets, and cross-venue spreads with institutional-level rigor. It moves beyond simple price comparison by enforcing the Locked Spread Protocol, which mandates that every leg of a trade describes the same economic outcome and accounts for all hidden costs.

By leveraging localized memory and standardized playbooks, the skill helps developers and traders normalize friction—including gas fees, slippage, FX spreads, and transfer latency—before declaring an opportunity profitable. It transforms raw market data into structured decision memos, ensuring that execution planning is based on fill risk and settlement mechanics rather than optimistic projections.

Arbitrage Use Cases

  • Evaluating cross-venue spot arbitrage between multiple exchanges or platforms.
  • Calculating matched book opportunities or surebets where implied probability is below 100%.
  • Analyzing prediction market baskets to find outcomes where total cost is below guaranteed payout.
  • Modeling basis or carry trades involving spot versus futures, perpetuals, or synthetic hedges.
  • Identifying retail pricing mismatches by comparing items across different sales channels while accounting for shipping and taxes.

How Arbitrage Works

  1. Leg Definition: The agent captures specific details for each leg, including venue, instrument, side, and settlement rules to ensure economic alignment.
  2. Normalization: Using calculator logic, the skill aggregates all friction points (fees, spread, financing, gas) to determine the net edge.
  3. Risk Classification: The opportunity is categorized as a full lock, soft-lock, or simple expected value (EV) to clarify the nature of the risk.
  4. Venue Validation: The agent checks venue-specific rules, liquidity depth, and withdrawal limits to identify execution bottlenecks.
  5. Decision Memo Generation: The skill outputs a final report detailing net edge, maximum realistic size, and clear kill conditions.

Arbitrage Setup

The Arbitrage skill requires a local directory for memory and configuration. Follow these steps to initialize:

# Create the arbitrage directory if it doesn't exist
mkdir -p ~/arbitrage/

# Initialize the skill memory using the setup guide
# (Ensure you have the required workflow and calculator files in place)

No API credentials or external binaries are required, ensuring a privacy-first analysis environment within Openclaw Skills.

Arbitrage Data Schema & Taxonomy

The skill organizes its intelligence within the ~/arbitrage/ directory using a clear taxonomy:

File Description
memory.md Stores user preferences, constraints, and activation rules.
opportunities.md Tracks active trade ideas, current status, and required next checks.
venue-notes.md A repository of settlement notes, withdrawal limits, and fill behavior by venue.
archive/ A sub-directory for historical opportunities and retired venue notes.

Arbitrage Advanced Features

  • Locked Spread Protocol: A strict 5-gate validation process that prevents the pursuit of 'fake edge' or mismatched settlement outcomes.
  • Fee-Aware Calculators: Specialized formulas that convert headline price gaps into true net profitability by factoring in FX, gas, and transfer drag.
  • Execution Sequencing: Intelligence that identifies the 'constrained leg' first (e.g., shallowest book) to minimize fill risk during execution.
  • Multi-Venue Playbooks: Pre-defined logic for handling complex settlement mechanics and counterparty exposure across different product types.
  • Automated Rejection Logic: Fast-fail mechanisms for stale quotes, low depth, and promo-only pricing traps.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*