# Surebet (Portuguese) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access live arbitrage, value, and middle betting opportunities from the SureBet platform to identify profitable bets across multiple sportsbooks. Get real-time data on guaranteed profits, undervalued odds, and middle bet positions directly from SureBet's official data source.

**Category:** Sports | **Website:** [pt.surebet.com/](https://pt.surebet.com/) | **Docs:** [parse.bot/marketplace/b1f63ed3-14f1-4485-8d3a-2dff0c0b5a69/pt-surebet-com-api](https://parse.bot/marketplace/b1f63ed3-14f1-4485-8d3a-2dff0c0b5a69/pt-surebet-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/surebet-portuguese/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get middlebets

Fetch middle/interval bets where overlapping odds ranges from different bookmakers create expected-value opportunities. Returns records sorted by expected value descending, each containing prong pairs with their EV, probability, and odds. Pagination is manual via cursor param using last record's sort_by value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bookmakers` | string | No | Pipe-separated bookmaker IDs to include. |
| `cursor` | string | No | Pagination cursor — use last record's sort_by value from previous page. |
| `limit` | integer | No | Max results per page. |
| `max_ev` | number | No | Maximum expected value filter. |
| `min_ev` | number | No | Minimum expected value filter. |
| `sport` | string | No | Pipe-separated sport names to filter by. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/surebet-portuguese/get-middlebets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bookmakers":"<string>","cursor":"<string>","limit":"<integer>","max_ev":"<number>","min_ev":"<number>","sport":"<string>"}'
```

### Get surebets

Fetch arbitrage bets (surebets) where combinations of odds across bookmakers guarantee profit regardless of outcome. Returns records sorted by profit descending, each containing prong pairs from different bookmakers with their odds, event details, and calculated profit/ROI. Pagination is manual via the cursor param using the last record's sort_by value; can_forward indicates whether more pages exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bookmakers` | string | No | Pipe-separated bookmaker IDs to include. |
| `cursor` | string | No | Pagination cursor — use last record's sort_by value from previous page. |
| `limit` | integer | No | Max results per page. |
| `max_profit` | number | No | Maximum profit percentage filter. |
| `min_profit` | number | No | Minimum profit percentage filter. |
| `order` | string | No | Sort order for results. |
| `outcomes` | integer | No | Number of outcomes to filter by (e.g. 2 for two-way bets, 3 for three-way). |
| `sport` | string | No | Pipe-separated sport names to filter by. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/surebet-portuguese/get-surebets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bookmakers":"<string>","cursor":"<string>","limit":"<integer>","max_profit":"<number>","min_profit":"<number>","order":"<string>","outcomes":"<integer>","sport":"<string>"}'
```

### Get valuebets

Fetch value bets where a bookmaker's odds exceed the calculated true probability, indicating an overvalued line. Returns records sorted by overvalue descending, each containing the bookmaker, odds, probability, and event details. Pagination is manual via cursor param using last record's sort_by value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bookmakers` | string | No | Pipe-separated bookmaker IDs to include. |
| `cursor` | string | No | Pagination cursor — use last record's sort_by value from previous page. |
| `limit` | integer | No | Max results per page. |
| `max_odds` | number | No | Maximum odds filter. |
| `max_overvalue` | number | No | Maximum overvalue percentage filter. |
| `min_odds` | number | No | Minimum odds filter. |
| `min_overvalue` | number | No | Minimum overvalue percentage filter. |
| `sport` | string | No | Pipe-separated sport names to filter by. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/surebet-portuguese/get-valuebets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bookmakers":"<string>","cursor":"<string>","limit":"<integer>","max_odds":"<number>","max_overvalue":"<number>","min_odds":"<number>","min_overvalue":"<number>","sport":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.