AI agent skill · by @alsk1992

Smarkets

Smarkets Exchange betting with 2% commission

Archived 2026-10-23 · Source updated 2026-10-02 · License: MIT. Check the original repository for the latest version.

SKILL.md instructions

# Smarkets Exchange

Full integration with Smarkets, a betting exchange with lower fees than Betfair (2% vs 5%). Politics, sports, and entertainment markets.

## Quick Start

```bash
# Set credentials
export SMARKETS_SESSION_TOKEN="your-session-token"

# Search markets
/sm markets election

# Get market prices
/sm prices 12345

# Place buy order
/sm buy 12345 67890 0.55 10

# Place sell order
/sm sell 12345 67890 0.60 10
```

## Commands

### Market Data

| Command | Description |
|---------|-------------|
| `/sm markets [query]` | Search markets |
| `/sm market <id>` | Get market details |
| `/sm prices <marketId>` | Current prices |
| `/sm book <marketId> <contractId>` | Show orderbook |

### Trading

| Command | Description |
|---------|-------------|
| `/sm buy <marketId> <contractId> <price> <quantity>` | Place buy order |
| `/sm sell <marketId> <contractId> <price> <quantity>` | Place sell order |
| `/sm cancel <orderId>` | Cancel order |
| `/sm cancelall [marketId]` | Cancel all orders |
| `/sm orders [marketId]` | List open orders |

**Examples:**
```bash
/sm buy 123 456 0.55 10    # Buy at 55% price, £10
/sm sell 123 456 0.60 10   # Sell at 60% price, £10
/sm cancel abc123          # Cancel specific order
```

### Account

| Command | Description |
|---------|-------------|
| `/sm balance` | Check account balance |

## Configuration

```bash
# Required for trading
export SMARKETS_SESSION_TOKEN="your-session-token"

# Optional - API token for market data only
export SMARKETS_API_TOKEN="your-api-token"
```

## Features

- **Low Fees** - 2% commission vs Betfair's 5%
- **Politics Markets** - UK, US, EU elections
- **Sports** - Football, tennis, horse racing
- **Entertainment** - TV, music, awards
- **Real-time Streaming** - WebSocket price updates

## Market Types

| Domain | Examples |
|--------|----------|
| politics | Elections, referendums |
| sport | Football, tennis, cricket |
| entertainment | Oscars, Eurovision, reality TV |
| current_affairs | Economic events, news |
| esports | CS:GO, League of Legends |

## Trading Notes

1. **Prices**: Expressed as percentages (0.55 = 55%)
2. **Quantities**: In GBP
3. **Buy**: Betting FOR an outcome
4. **Sell**: Betting AGAINST an outcome

## Resources

- [Smarkets Exchange](https://smarkets.com/)
- [Smarkets API Docs](https://docs.smarkets.com/)