Quickstart

You should have an API key and wallet private key for the same Trepa account (API keys, Wallet private key). This page uses Trepa’s official @trepa/sdk package. You create a small project, store both secrets in .env, then run a script built around trepa.bots.run. You start with a tiny fixed forecast and each pool’s minimum stake, then swap in a live BTC spot feed from Binance for the forecast. You need Node.js 22.12 or newer installed locally before you begin.

1. Create the project

mkdir my-trepa-bot && cd my-trepa-bot
npm init -y
npm pkg set type=module
npm install @trepa/sdk

Create .env next to package.json:

TREPA_API_KEY=trp_your_api_key
TREPA_PRIVATE_KEY=your_base58_wallet_private_key

Keep secrets out of git:

echo ".env" >> .gitignore

2. Add the bot script

Create bot.ts. The smallest loop fixes a forecast and uses the pool’s minimum stake:

import { credentialsFromEnv, Trepa } from '@trepa/sdk'

const trepa = new Trepa({ credentials: credentialsFromEnv() })

await trepa.bots.run({
  predict: (pool) => ({
    value: 65_000,
    stake: pool.min_stake,
  }),
})

That version hard-codes the forecast. Below, the same structure reads the latest BTCUSDT price from Binance and uses it as the forecast each round:

import { credentialsFromEnv, Trepa } from '@trepa/sdk'

const trepa = new Trepa({ credentials: credentialsFromEnv() })

async function btcSpot(): Promise<number> {
  const res = await fetch(
    'https://data-api.binance.vision/api/v3/ticker/price?symbol=BTCUSDT',
  )
  const { price } = (await res.json()) as { price: string }
  return Number(price)
}

await trepa.bots.run({
  predict: async (pool) => ({
    value: await btcSpot(),
    stake: pool.min_stake,
  }),
})

bots.run waits for an open pool, runs your function, signs with the wallet key, submits, then waits again.

3. Run it

From the project directory:

node --env-file=.env bot.ts

Press Ctrl+C to stop. The SDK signs out cleanly before the process exits. When you are ready to change behaviour such as skipping rounds, hooks, or revising a forecast, continue to Writing bots. Next: Writing bots.

Your first bot

Customize & scale

REST & limits

API reference

1. Create the project

2. Add the bot script

3. Run it

​1. Create the project

​2. Add the bot script

​3. Run it

1. Create the project

2. Add the bot script

3. Run it