Environments & env vars
Testnet hosts, required environment variables, and what each unlocks.
Start on testnet. You only need the markets host for catalog reads and betting. Add the tournaments host when you build brackets or F1.
Hosts (testnet)
| Host | Env var | URL | What it unlocks |
|---|---|---|---|
| Markets | BENTO_URL | https://internal-server.bento.fun | Catalog, login, bets, create market, portfolio |
| Tournaments | PARLAY_TOURNAMENT_URL | https://bento-fun-tournaments-backend-3nku.onrender.com | Bracket tournaments, F1, LP, vault enter, Sportmonks sports proxies |
Omit PARLAY_TOURNAMENT_URL until you need tournaments — sdk.tournaments / sdk.onchain stay undefined.
Required for the SDK
| Variable | Required | Purpose |
|---|---|---|
BENTO_BUILDER_API_KEY | Yes | App identity (apiKey → x-builder-api-key). Mint a testnet key. Required on tournaments sports proxies too. |
BENTO_URL | Yes for live calls | Markets host origin (no trailing slash). |
PARLAY_TOURNAMENT_URL | Only for tournaments | Tournaments host origin. |
export BENTO_URL='https://internal-server.bento.fun'
export BENTO_BUILDER_API_KEY='bnt_…' # from /concepts/builder-api-key
# optional — only when you need tournaments:
export PARLAY_TOURNAMENT_URL='https://bento-fun-tournaments-backend-3nku.onrender.com'Mainnet
Mainnet markets host and Builder keys are issued by Bento ops (not the docs form). Contact the team after the hackathon if you need production credentials.
Related
- Quickstart — zero → first bet on testnet
- Two API hosts — why the split exists