Direct REST access

Trepa recommends the official @trepa/sdk package for TypeScript and Node. This guide is for integrations that call the HTTP API directly: another language, curl, or your own client. You use the same API key and wallet private key as SDK-based bots. Two ideas drive every integration:

Session cookies after you exchange the API key for a session.
Create, sign, submit for each on-chain action (predictions, claims, withdrawals).

Paths, bodies, and status codes are in the API Reference tab.

Session cookies

Authentication always starts by trading your API key for cookies: POST /auth/session with header trepa-api-key returns Set-Cookie headers (no JSON body):

Cookie	Role
`trepa-token`	Short-lived access token for normal requests.
`trepa-refresh`	Refresh token; use only with `POST /auth/refresh`.

curl -X POST "https://api.trepa.app/auth/session" \
  -H "trepa-api-key: trp_your_key" \
  -c cookies.txt

curl "https://api.trepa.app/streak/bitcoin" -b cookies.txt

curl -X POST "https://api.trepa.app/auth/refresh" \
  -b cookies.txt -c cookies.txt

Expired access tokens return 403 or 401 on /auth/*. Call /auth/refresh, refresh your cookie jar, retry.

Create, sign, submit

Authenticated writes always follow the same three steps:

Create: POST the /transactions/... route. Body includes { transaction, proof } where transaction is an unsigned base64 VersionedTransaction.
Sign: Deserialize, sign with your wallet key, serialize, base64-encode again.
Submit: POST the paired /transactions/.../submit route with signed_transaction and the original proof.

Action	Create	Submit
Place a prediction	`POST /transactions/prediction`	`/transactions/prediction/submit`
Update prediction value	`POST /transactions/prediction/update`	`/transactions/prediction/update/submit`
Update stake	`POST /transactions/stake/update`	`/transactions/stake/update/submit`
Claim pool reward	`POST /transactions/claim-reward`	`/transactions/claim-reward/submit`
Claim streak reward	`POST /transactions/claim-streak-reward`	`/transactions/claim-streak-reward/submit`
Withdraw USDC	`POST /transactions/withdraw`	`/transactions/withdraw/submit`

Here is one full prediction round-trip in Node:

Node example (prediction)

import { Keypair, VersionedTransaction } from '@solana/web3.js'
import bs58 from 'bs58'

const { transaction, proof } = await fetch(
  `${BASE_URL}/transactions/prediction`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', Cookie: cookieHeader },
    body: JSON.stringify({ pool_id: POOL_UUID, stake: 1.0, value: 65_000 }),
  },
).then((r) => r.json())

const tx = VersionedTransaction.deserialize(Buffer.from(transaction, 'base64'))
tx.sign([Keypair.fromSecretKey(bs58.decode(PRIVATE_KEY))])
const signedTransaction = Buffer.from(tx.serialize()).toString('base64')

await fetch(`${BASE_URL}/transactions/prediction/submit`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Cookie: cookieHeader },
  body: JSON.stringify({ pool_id: POOL_UUID, signed_transaction, proof }),
})

The same pattern ports to Python (solders), Rust (solana-sdk), or other stacks you already use. Next: Rate limits.

Your first bot

Customize & scale

REST & limits

API reference

Session cookies

Create, sign, submit

Node example (prediction)

​Session cookies

​Create, sign, submit

​Node example (prediction)

Session cookies

Create, sign, submit

Node example (prediction)