Skills Hub

The XBTFX Skills Hub provides pre-built AI skills that teach agents how to use the XBTFX Trading API. Each skill is a structured SKILL.md file containing endpoint documentation, parameter schemas, example requests, and behavioral guidelines.

Repository: github.com/XBTFX/xbtfx-skills-hub

What Is a Skill?

A skill is a structured markdown file with YAML frontmatter and human-readable instructions. It provides everything an AI agent needs to use a specific set of API endpoints:

Frontmatter — name, description, required environment variables
When to use / When not to use — helps agents select the right skill
Endpoint reference — methods, paths, parameters, response schemas
Code examples — ready-to-use request/response pairs
Agent guidelines — behavioral rules for safe and correct operation

Available Skills

Skill	Type	Description
Trading	Read/Write	Open, close, modify, reverse, and close-by positions
Account	Read-only	Balance, equity, margin, leverage, positions, orders, history
Market Data	Read-only	Symbol specifications, volume constraints, live bid/ask
WebSocket	Read-only	Real-time streaming quotes and account events

Usage with Agent Frameworks

Claude Code

claude --skill ./skills/xbtfx/xbtfx-trading/SKILL.md

LangChain

Ingest the SKILL.md content as a tool description or system prompt supplement for your agent.

CrewAI

Reference the SKILL.md file in your agent’s instructions or backstory configuration.

Custom Implementations

Parse the structured markdown to extract endpoint definitions, parameter schemas, and behavioral guidelines for your agent framework.

Installation

git clone https://github.com/XBTFX/xbtfx-skills-hub.git

Set the required environment variable:

export XBTFX_API_KEY="your-api-key-here"

API keys are created at console.xbtfx.com. Each key binds to a single MT5 login.

Repository Structure

skills/xbtfx/
  xbtfx-trading/      # Open, close, modify, reverse positions
  xbtfx-account/      # Balance, equity, margin, trade history
  xbtfx-market-data/  # Symbols, contract specs, live quotes
  xbtfx-websocket/    # Real-time price feeds and position updates

Each directory contains a SKILL.md file that can be loaded independently by any agent framework.