Quickstart guide

# Install via pip
pip install evsignals

# Or with poetry
poetry add evsignals

// Install via npm
npm install evsignals

// Or with yarn
yarn add evsignals

# No installation needed!
# cURL comes pre-installed on most systems

# Verify your installation:
curl --version

import os
import evsignals

# Option 1: Use environment variable (recommended)
# Set EVSIGNALS_API_KEY in your environment first:
# export EVSIGNALS_API_KEY="evs_live_your_api_key_here"
client = evsignals.Client()  # Auto-loads from env

# Option 2: Pass API key directly
client = evsignals.Client(
    api_key="evs_live_your_api_key_here"
)

# Make a small authenticated request
signals = client.signals.list(limit=1)
print(f"Authenticated. Retrieved {len(signals.data)} signal(s).")

import EVSignals from 'evsignals';

// Option 1: Use environment variable (recommended)
// Set EVSIGNALS_API_KEY in your environment first:
// export EVSIGNALS_API_KEY="evs_live_your_api_key_here"
const client = new EVSignals();  // Auto-loads from env

// Option 2: Pass API key directly
const client = new EVSignals({
  apiKey: 'evs_live_your_api_key_here'
});

// Make a small authenticated request
const signals = await client.signals.list({ limit: 1 });
console.log(`Authenticated. Retrieved ${signals.data.length} signal(s).`);

# Set your API key as an environment variable
export EVSIGNALS_API_KEY="evs_live_your_api_key_here"

# Make a small authenticated request
curl "https://api.evsignals.com/v1/signals?limit=1" \
  -H "Authorization: Bearer $EVSIGNALS_API_KEY" \
  -H "Content-Type: application/json"

# List active signals with a minimum edge
signals = client.signals.list(
    min_ev=0.02,                     # Minimum 2% edge
    markets=["kalshi", "polymarket"],
    status="active",
    limit=10
)

# Process the results
for signal in signals.data:
    print(f"{signal.market} | {signal.contract_name} | {signal.ev_percent}% EV")

// List active signals with a minimum edge
const signals = await client.signals.list({
  minEv: 0.02,                     // Minimum 2% edge
  markets: ['kalshi', 'polymarket'],
  status: 'active',
  limit: 10
});

// Process the results
signals.data.forEach(signal => {
  console.log(`${signal.market} | ${signal.contractName} | ${signal.evPercent}% EV`);
});

# Get active +EV signals
curl "https://api.evsignals.com/v1/signals?min_ev=0.02&markets[]=kalshi&markets[]=polymarket&status=active&limit=10" \
  -H "Authorization: Bearer $EVSIGNALS_API_KEY" \
  -H "Content-Type: application/json"

# Response:
# {
#   "data": [
#     {
#       "id": "sig_abc123",
#       "market": "kalshi",
#       "contract_name": "Chiefs to win",
#       "ev_percent": 5.25,
#       "current_price": 0.46
#     }
#   ]
# }

# Set up a webhook for real-time alerts
webhook = client.webhooks.create(
    url="https://yourapp.com/webhooks/evsignals",
    events=["signal.created", "signal.expired"],
)

print(f"Webhook created: {webhook.id}")
print(f"Signing secret: {webhook.secret}")

// Set up a webhook for real-time alerts
const webhook = await client.webhooks.create({
  url: 'https://yourapp.com/webhooks/evsignals',
  events: ['signal.created', 'signal.expired'],
});

console.log(`Webhook created: ${webhook.id}`);
console.log(`Signing secret: ${webhook.secret}`);

# Create a webhook
curl -X POST "https://api.evsignals.com/v1/webhooks" \
  -H "Authorization: Bearer $EVSIGNALS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/webhooks/evsignals",
    "events": ["signal.created", "signal.expired"]
  }'