Pinnacle Setup Guide

Time: 10 minutes | Difficulty: Moderate | Market: Sports Betting Mode: Full automation | API: REST API (Odds + Betting) | Docs: pinnacleapi.github.io

This guide wires a Pinnacle sports betting bot to the REST API using the botwir3 runtime. Configure API credentials, connect to Pinnacle's sharp-friendly exchange, and run automated betting strategies locally.

Before you start

Verify that automated operation is permitted under Pinnacle's current terms of service before deploying. botwir3 provides tools for building structured automation. The user is responsible for compliance with the platform's terms and all applicable regulations.

⚠ Jurisdiction. Pinnacle is not available in the United States or the United Kingdom. Verify availability in the applicable jurisdiction before proceeding.

Pinnacle Terms and Conditions | Last verified: May 2026

What you need

• A Pinnacle account with a funded balance
• API access (available to funded accounts)
• The botwir3 runtime downloaded and unzipped
• A strategy config file from the builder

Step 1: Create API credentials

1. Log in to pinnacle.com
2. Contact Pinnacle support or access the API section in account settings to enable API access
3. API authentication uses the account username and password (Basic Auth over HTTPS)

Permissions required: API access is granted at the account level. Permissions to disable: N/A. Withdrawal is not available through the API.

🔒 Security. Pinnacle API uses Basic Auth over HTTPS. The API does not grant withdrawal access. Fund transfers require the Pinnacle website. Credentials are stored in a local config file and are not transmitted to botwir3 or any third party. botwir3 never sees, stores, or has access to platform credentials.

Step 2: Configure the adapter

Create adapter.json in the bot directory:

{
  "adapter": "pinnacle",
  "credentials": {
    "username": "paste-pinnacle-username-here",
    "password": "paste-pinnacle-password-here"
  },
  "sport_id": 29,
  "environment": "live",
  "rate_limit_ms": 1000
}

sport_id: 29 = Soccer, 4 = Basketball (NBA), 1 = Football (NFL), 6 = Ice Hockey (NHL), 33 = Tennis. See the Pinnacle API sports endpoint for the full list.

Step 3: Test the connection

botwir3 test --adapter pinnacle

Expected output:

[botwir3] Adapter: pinnacle
[botwir3] Connection: OK
[botwir3] Permissions: betting
[botwir3] Rate limit: per API documentation

Step 4: Start the bot

botwir3 start --config my-strategy.json

The runtime loads the strategy, computes the spec hash, connects to Pinnacle via the local credentials, and begins evaluating signals. The gate function compares proposed actions against the configured spec. The user is responsible for monitoring the bot and verifying execution outcomes.

Rate limits and considerations

ℹ Sharp-friendly. Pinnacle does not limit or restrict winning accounts. This distinguishes it from most sportsbooks, which reduce limits for profitable bettors. Pinnacle's margin (vig) is also among the lowest in the industry.

Common Pinnacle bot configurations include value betting (identifying lines where the model's probability exceeds the implied odds), closing line value tracking, and automated Kelly criterion-based staking across multiple sports and markets. All actions and decisions are recorded in the local ledger.

Troubleshooting

Related guides

• Betfair Exchange Setup Guide — sports betting, exchange model (not US)
• The Odds API Setup Guide — odds aggregator, data source for signal strategies
• TradingView Webhooks Setup Guide — route alert signals to any adapter

One bot. $129. No subscription. No $749/mo platform. → Build for Pinnacle