How to Set Up Your AI Agent with Bet Boyz

Bet Boyz doesn’t have an app. No dashboard. No login screen with a forgot-password flow.

Instead, you talk to your AI agent and it talks to our API. We call this BYOA: Bring Your Own Agent. You use whatever AI you already use — Claude, GPT, Gemini, your own custom agent — and give it a skill file that teaches it how to use every endpoint we have.

This post walks you through the full setup. It takes about 5 minutes.

What You Get

Once your agent is connected, it can:

• Track every bet you place across 13 bet types (moneyline, spread, parlay, teaser, props, futures, round robin, same-game parlay, live bets, and more)
• Manage sportsbook accounts, both real ones like FanDuel and DraftKings, and paper accounts for testing strategies without risking money
• Settle bets with per-leg outcomes so your records are accurate
• Run analytics: overall P&L, breakdowns by sport, bet type, and sportsbook, win/loss streaks, time-of-day patterns
• Detect cognitive biases. Are you chasing losses? Overweighting parlays? Betting on tilt after a bad beat? The API flags it.
• Search for teams and players across leagues

Your agent handles all of it through conversation.

Step 1: Register

No credit card. No email verification. Just hit the endpoint.

Ask your agent to run this (or do it yourself with curl):

POST https://api.betboyz.app/v1/customers/register
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "YourPassword1"
}

Password needs at least 8 characters with an uppercase letter, lowercase letter, and a digit.

You’ll get back your customer profile with a trial tier. Trials last 14 days with 30 requests per minute and 500 per day. That’s plenty to get started.

Step 2: Get Your API Key

Log in first to get a session token:

POST https://api.betboyz.app/v1/customers/login
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "YourPassword1"
}

Then create an API key using that session token:

POST https://api.betboyz.app/v1/keys
Authorization: Bearer session_...your_token_here...
Content-Type: application/json

{
  "name": "My Agent Key"
}

Save the key that comes back. It’s only shown once. If you lose it, you’ll need to revoke it and create a new one.

The key defaults to all scopes — bets, analytics, odds, accounts. You can restrict it if you want, but for getting started, all scopes is fine.

Step 3: Create a Sportsbook Account

Every bet is linked to a sportsbook account. Create at least one:

Real sportsbook:

POST https://api.betboyz.app/v1/accounts
Authorization: Bearer your_api_key
Content-Type: application/json

{
  "bookmaker_key": "fanduel",
  "display_name": "My FanDuel"
}

Available bookmakers: fanduel, draftkings, betmgm, caesars, pointsbet, barstool, betrivers, unibet.

Paper account (for testing strategies):

POST https://api.betboyz.app/v1/accounts
Authorization: Bearer your_api_key
Content-Type: application/json

{
  "is_paper": true,
  "paper_name": "NFL Test Strategy",
  "initial_balance": 1000.00
}

Paper accounts let you track hypothetical bets without real money. Log bets, settle them, compare your paper P&L against your real accounts. It’s backtesting for sports bettors.

Step 4: Give Your Agent the Skill File

This is where BYOA happens. We published a skill file — one markdown document that teaches your AI agent every endpoint, every parameter, every response format.

Get it here: github.com/zjorichardson/betboyz-plugin

Claude Code

Copy SKILL.md into your project:

mkdir -p .claude/skills/betboyz
curl -o .claude/skills/betboyz/SKILL.md https://raw.githubusercontent.com/zjorichardson/betboyz-plugin/main/SKILL.md

Set your environment variables:

export BETBOYZ_BASE_URL=https://api.betboyz.app
export BETBOYZ_API_KEY=your_key_here

That’s it. Claude now knows how to use the entire API.

Other AI Agents (GPT, Gemini, Custom)

Load the contents of SKILL.md into your agent’s system prompt or tool context. The file covers every request format, response schema, error code, and common workflow. It’s the full reference.

Make sure your agent has access to the BETBOYZ_BASE_URL and BETBOYZ_API_KEY values, however your platform handles environment variables or secrets.

Step 5: Start Using It

Now just talk to your agent. Here are some things you can say:

Log a bet:

“I put $50 on the Chiefs moneyline at -150 on FanDuel”

Log a parlay:

“I placed a $20 parlay on FanDuel: Chiefs moneyline -150 and Packers -3.5 spread at -110. Combined odds +600.”

Settle a bet:

“The Chiefs won. Settle my moneyline bet as a win, payout was $83.33”

Check your performance:

“How am I doing overall? What’s my ROI?”

Check for biases:

“Am I chasing losses? Run the bias check.”

Compare sportsbooks:

“Which sportsbook am I most profitable on?”

Test a strategy:

“Create a paper account for testing NFL totals. Start with $500.”

Your agent translates your natural language into API calls and gives you the results. No forms. No dropdowns. No navigation. Just conversation.

What BYOA Actually Means

Most platforms lock you into their interface. Their app. Their notification system. Their version of what your data should look like.

BYOA flips that. You choose the agent. You choose the interface. We provide the data layer.

If you switch from Claude to GPT next month, you don’t lose anything. Same API, same data, same key. Just give the new agent the skill file and keep going.

Your betting data stays yours. Access it from whatever AI you want.

What’s Next

We’re building in public. On the roadmap:

• Live odds from multiple sportsbooks
• Auto-settlement from live scores (currently manual)
• More bias indicators beyond the initial four
• Bankroll management recommendations
• Odds comparison alerts across sportsbooks

Follow @Bet_Boyz_Brand on X for updates.

Gambling problem? Call 1-800-522-4700.

Bet Boyz helps you track and analyze your betting. We don’t place bets for you, and we don’t take money to promote sportsbooks. Even with data on your side, gambling involves risk. Never bet what you can’t afford to lose.