basis-arb

Identifies trading opportunities by comparing spot and perpetual prices.

226|9|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/Superior-Trade/superior-skills --skill basis-arb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: basis-arb
Source: https://github.com/Superior-Trade/superior-skills/tree/main/skills/basis-arb
Command: npx skills add https://github.com/Superior-Trade/superior-skills --skill basis-arb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires freqtrade, pypdf, and includes scripts (resource) components.

What problem does it solve?

This Skill identifies trading opportunities based on the spot-perp basis, enabling users to make directional bets on asset positioning.

Core Features & Use Cases

  • Spot-Perp Basis Analysis: Compares the spot and perpetual price of assets to determine the basis.
  • Directional Positioning: Uses the basis as a signal to enter long or short positions on the perpetual market.
  • Use Case: A user may utilize this Skill to go long the perpetual market if the spot price is higher than the perpetual price, indicating a potential opportunity for arbitrage.

Quick Start

Activate the 'basis-arb' skill to analyze the spot-perp basis for BTC/USDC:USDC and trigger a long position if the basis is negative and the funding rate is positive.

Frequently Asked Questions about basis-arb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is spot-perp basis trading and how does it signal directional positioning?

The spot-perp basis identifies arbitrage opportunities by comparing spot and perpetual asset prices. If the spot price is higher than the perpetual price, it signals a potential opportunity to enter a long position on the perpetual market.

How do I calculate the spot-perp basis for crypto trading?

You calculate the spot-perp basis by comparing the spot and perpetual prices of assets. This skill uses pypdf for basis calculation and requires Freqtrade to execute the resulting directional trades on the perpetual market.

Do I need Freqtrade and pypdf to execute basis arbitrage strategies?

Yes, you need Freqtrade and pypdf to run this skill. Freqtrade handles trade execution while pypdf supports the basis calculation required to identify directional arbitrage opportunities in perpetual markets.

When should I enter a long position based on the spot-perp basis?

You should enter a long position on the perpetual market when the spot price is higher than the perpetual price, creating a negative basis. This indicates a potential arbitrage opportunity for directional positioning.