Juice Reel developer platform

Build with verified betting data

Connect a Juice Reel account with OAuth 2.0, then securely read subscriber relationships and the connected user's open or settled bets from your backend.

Authorization URLhttps://www.juicereel.com/oauth2/authorize

API base URLhttps://external-api.juicereel.com

1Create an applicationRegister callbacks and request only the scopes you need.

2Authorize with PKCEValidate state and exchange the short-lived code server-side.

3Call the APIUse a bearer token plus client ID for connected users, or your client ID and secret for your own account.

OAuth 2.0

Authorize a user

Send the user to Juice Reel to sign in and approve access. This is a browser redirect, not a server-to-server API call.

GEThttps://www.juicereel.com/oauth2/authorize

AuthenticationJuice Reel browser session

Required scopeNone

Keep the PKCE verifier on your backend. Only its S256 challenge is sent to Juice Reel.

See code example

Request query parameters

Field	Type	Description
`client_id`required	string	Your approved OAuth client ID.
`redirect_uri`required	string	An exact redirect URI registered on the application.
`response_type`required	string	Must be code.
`scope`required	string	Space-delimited requested scopes. Send an empty value for identity-only access.
`state`required	string	Unpredictable value created and validated by your application.
`code_challenge`required	string	Base64url SHA-256 digest of your PKCE verifier.
`code_challenge_method`required	string	Must be S256.

Response

302 · redirect

Field	Type	Description
`code`	string	Short-lived, single-use authorization code exchanged by your backend.
`state`	string	The original state. Reject the callback if it does not exactly match your stored value.

Browser redirect · Node.js

Node.js

const sessionId = crypto.randomBytes(32).toString("base64url");
const state = crypto.randomBytes(32).toString("base64url");
const verifier = crypto.randomBytes(32).toString("base64url");
const challenge = crypto
  .createHash("sha256")
  .update(verifier)
  .digest("base64url");

// Store state and verifier in your server-side session.
sessions.set(sessionId, { state, verifier });

const authorizeUrl = new URL(config.authorizationUrl);
authorizeUrl.search = new URLSearchParams({
  client_id: config.clientId,
  redirect_uri: config.redirectUri,
  response_type: "code",
  response_mode: "query",
  scope: config.scopes.join(" "),
  state,
  code_challenge: challenge,
  code_challenge_method: "S256",
}).toString();

// Redirect the user's browser to Juice Reel.
response.writeHead(302, { Location: authorizeUrl.toString() });
response.end();

After login

JSON

HTTP/1.1 302 Found
Location: https://your-app.example/callback?code=<AUTHORIZATION_CODE>&state=<STATE>

OAuth 2.0

Exchange an authorization code

Exchange the callback code for an access token and rotating refresh token. Perform this request only from your backend.

POST/oauth2/token

AuthenticationHTTP Basic: client ID and client secret

Required scopeNot applicable

SECURITY WARNING: Call this endpoint only from your backend. Never call it from browser or mobile frontend code. Your client secret must never be included in frontend application bundles, shipped to users, or exposed to clients.

Request query parameters

Field	Type	Description
`grant_type`required	string	Must be authorization_code.
`code`required	string	Code received by your redirect URI.
`redirect_uri`required	string	Must exactly match the URI used during authorization.
`code_verifier`required	string	Original PKCE verifier used to create the challenge.

Response

200 · application/json

Field	Type	Description
`access_token`	string	Bearer token used for resource requests. Store server-side.
`refresh_token`	string	Single-use token used to obtain a replacement token pair.
`token_type`	string	Bearer.
`expires_in`	integer	Access-token lifetime in seconds; currently 3600.
`scope`	string	Space-delimited scopes granted by the user.

Request

cURL

curl --request POST \
  --url "https://external-api.juicereel.com/oauth2/token" \
  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "grant_type=authorization_code" \
  --data-urlencode "code=${AUTHORIZATION_CODE}" \
  --data-urlencode "redirect_uri=${REDIRECT_URI}" \
  --data-urlencode "code_verifier=${CODE_VERIFIER}"

200 response

JSON

{
  "access_token": "<ACCESS_TOKEN>",
  "refresh_token": "<REFRESH_TOKEN>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "subscribers.read bets.open.read bets.settled.read"
}

OAuth 2.0

Refresh tokens

Use a refresh token once to receive a new access token and a replacement refresh token.

POST/oauth2/token

AuthenticationHTTP Basic: client ID and client secret

Required scopeNot applicable

Request query parameters

Field	Type	Description
`grant_type`required	string	Must be refresh_token.
`refresh_token`required	string	The current unused refresh token.

Response

200 · application/json

Field	Type	Description
`access_token`	string	New one-hour bearer token.
`refresh_token`	string	Replacement refresh token. Discard the token used for this request.
`token_type`	string	Bearer.
`expires_in`	integer	Access-token lifetime in seconds.
`scope`	string	Scopes retained by the authorization grant.

Request

cURL

curl --request POST \
  --url "https://external-api.juicereel.com/oauth2/token" \
  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "grant_type=refresh_token" \
  --data-urlencode "refresh_token=${REFRESH_TOKEN}"

200 response

JSON

{
  "access_token": "<ACCESS_TOKEN>",
  "refresh_token": "<REFRESH_TOKEN>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "subscribers.read bets.open.read bets.settled.read"
}

OAuth 2.0

Revoke tokens

Revoke an access token or refresh-token grant when a user disconnects Juice Reel from your application.

POST/oauth2/revoke

AuthenticationHTTP Basic: client ID and client secret

Required scopeNot applicable

Request query parameters

Field	Type	Description
`token`required	string	Access token or refresh token to revoke.
`token_type_hint`	string	Optional access_token or refresh_token hint.

Response

200 · application/json

Field	Type	Description
`HTTP 200`	empty object	Revocation is idempotent and does not reveal whether the token existed.

Request

cURL

curl --request POST \
  --url "https://external-api.juicereel.com/oauth2/revoke" \
  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "token=${TOKEN_TO_REVOKE}" \
  --data-urlencode "token_type_hint=refresh_token"

200 response

JSON

{}

Checkout

Create a checkout session

Create a hosted checkout session that wraps the Juice Reel purchase flow. Redirect the user's browser to checkoutUrl; after checkout succeeds, Juice Reel shows the OAuth consent screen and then redirects to successUrl with a short-lived authorization code and the supplied state. A cancelled checkout redirects to cancelUrl with its status and state. Exchange the authorization code at /oauth2/token; access tokens and client secrets must never be placed in URLs.

POST/checkout/sessions

AuthenticationHTTP Basic: client ID and client secret

Required scopeNot applicable

Request body

Field	Type	Description
`successUrl`required	string	Exact redirect URI registered on the OAuth application for a successful checkout.
`cancelUrl`required	string	Exact redirect URI registered on the OAuth application for a cancelled checkout.
`scopes`required	string[]	Requested OAuth scopes. May be an empty array for identity-only access; otherwise scopes must be unique and a subset of the scopes approved for the OAuth application.
`state`required	string	Opaque value generated by your backend and returned unchanged to your successUrl or cancelUrl.
`codeChallenge`required	string	PKCE S256 code challenge generated by your backend for the authorization-code exchange.

Response

201 · application/json

Field	Type	Description
`checkoutSessionId`	string	Unique identifier for the checkout session.
`checkoutUrl`	string	URL to open in the user's browser to begin checkout.
`expiresAt`	string (ISO 8601)	Time at which the checkout session expires.

Request

cURL

curl --request POST \
  --url "https://external-api.juicereel.com/checkout/sessions" \
  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}" \
  --header "Content-Type: application/json" \
  --data '{
    "successUrl": "https://your-app.example/juicereel/callback",
    "cancelUrl": "https://your-app.example/juicereel/callback",
    "scopes": ["subscribers.read"],
    "state": "YOUR_STATE",
    "codeChallenge": "YOUR_S256_CODE_CHALLENGE"
  }'

201 response

JSON

HTTP/1.1 201 Created
{
  "checkoutSessionId": "b42eb212-8369-4fc5-9e74-54d4c9b9c3fa",
  "checkoutUrl": "https://www.juicereel.com/checkout/sessions/b42eb212-8369-4fc5-9e74-54d4c9b9c3fa",
  "expiresAt": "2026-09-11T15:16:58.515Z"
}

After checkout

URL

// Successful checkout and OAuth consent
GET https://your-app.example/juicereel/callback?status=success&code=<AUTHORIZATION_CODE>&state=<STATE>

// Cancelled checkout or declined OAuth consent
GET https://your-app.example/juicereel/callback?status=cancelled&state=<STATE>

Account

Get the connected user

Return the connected user ID represented by a bearer token, or the OAuth app owner when using client credentials.

GET/oauth2/me

Authentication

OAuth user accessBearer token + client ID

Owner onlyClient ID + secret

Required scopeNone

Use bearer authentication to identify a connected user, or client credentials to identify the OAuth app owner. No optional scope is required.

Response

200 · application/json

Field	Type	Description
`id`	integer	Stable Juice Reel user identifier for the authorization grant.
`displayName`	string	User's current public display name.

Request

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/me" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

Owner request · client credentials

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/me" \
  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

200 response

JSON

{
  "id": 4,
  "displayName": "Sharp Bettor"
}

Subscribers

List all subscribers

List everyone who has ever subscribed to the OAuth application owner, including expired and sandbox subscriptions.

GET/oauth2/subscribers/current

AuthenticationHTTP Basic: client ID and client secret

Required scopeNone

Response

200 · application/json

Field	Type	Description
`subscribers`	array	All subscriber records for the OAuth application owner, including expired subscriptions, ordered by latest expiration and creation time.
`subscriptionProductId`	string	Stable identifier of the subscription product purchased from the application owner.
`userId`	integer	Subscriber's stable Juice Reel user ID.
`expiresDate`	datetime	ISO 8601 expiration or renewal boundary.
`isCurrentlySubscribed`	boolean	True when expiresDate is later than the time of the API request.
`User.id`	integer	Subscriber's stable Juice Reel user ID.
`User.displayName`	string	Subscriber's current Juice Reel display name.
`SubscriptionProduct.duration`	string	Billing duration: WEEKLY, MONTHLY, or YEARLY.

Request

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/subscribers/current" \
	  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

200 response

JSON

{
  "subscribers": [
    {
      "subscriptionProductId": "monthly-premium",
      "userId": 21874,
      "expiresDate": "2026-10-02T14:31:00.000Z",
      "isCurrentlySubscribed": true,
      "User": {
        "id": 21874,
        "displayName": "Sharp Bettor"
      },
      "SubscriptionProduct": {
        "duration": "MONTHLY"
      }
    }
  ]
}

Subscribers

Get subscription status

Check whether the user represented by the access token is currently subscribed to the OAuth application owner.

GET/oauth2/subscribers/status

AuthenticationBearer token and X-OAuth-Client-Id

Required scopesubscribers.read

Returns true without a subscription field when the authenticated user owns the OAuth application. Expired and never-subscribed users receive false without a subscription field.

Response

200 · application/json

Field	Type	Description
`isCurrentlySubscribed`	boolean	True when the authenticated user has a non-expired subscription to the OAuth application owner.
`subscription`	object \| omitted	Active subscription record. Omitted when no active record exists or the authenticated user owns the application.
`subscription.subscriptionProductId`	string	Stable identifier of the purchased subscription product.
`subscription.userId`	integer	Subscriber's stable Juice Reel user ID.
`subscription.expiresDate`	datetime	ISO 8601 expiration or renewal boundary.
`subscription.isCurrentlySubscribed`	boolean	True when this subscription record has not expired.
`subscription.SubscriptionProduct.duration`	string	Billing duration: WEEKLY, MONTHLY, or YEARLY.

Request

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/subscribers/status" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

200 response

JSON

{
  "isCurrentlySubscribed": true,
  "subscription": {
    "subscriptionProductId": "monthly-premium",
    "userId": 21874,
    "expiresDate": "2026-10-02T14:31:00.000Z",
    "isCurrentlySubscribed": true,
    "SubscriptionProduct": {
      "duration": "MONTHLY"
    }
  }
}

Bets

List open bets

Return the connected user's open bets using cursor-based pagination.

GET/oauth2/bets/open

Authentication

OAuth user accessBearer token + client ID

Owner onlyClient ID + secret

Required scopebets.open.read

If neither datePlacedAfter nor datePlacedBefore is supplied, all available open-bet history is considered. The after boundary is inclusive and the before boundary is exclusive. Results are ordered by descending bet ID. Never modify or decode the cursor to drive application logic.

Request query parameters

Field	Type	Description
`datePlacedAfter`	string	Optional inclusive lower bound for bet placement time, as an ISO 8601 datetime. Omit to include the earliest available bets.
`datePlacedBefore`	string	Optional exclusive upper bound for bet placement time, as an ISO 8601 datetime. Omit to include the latest available bets.
`cursor`	string	Opaque nextCursor from the previous response. Omit for the first page; reuse the same date filters when requesting the next page.

Response

200 · application/json

Field	Type	Description
`nextCursor`	string \| null	Pass this opaque value as cursor on the next request. Null means paging is complete.
`hasMore`	boolean	True when another page is available. Equivalent to nextCursor being non-null.
	Bet	A bet in descending ID order for the connected Juice Reel user.

Request

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/bets/open?cursor=${NEXT_CURSOR}" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

Owner request · client credentials

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/bets/open?cursor=${NEXT_CURSOR}" \
  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

200 response

JSON

{
  "bets": [
    {
      "id": 9531,
      "userId": 4,
      "oddsAmerican": 114,
      "amountRisked": 0.5886,
      "toWin": 0.6714,
      "netResult": -0.5886,
      "result": "Lost",
      "datePlaced": "2026-08-11T13:32:26.434Z",
      "dateClosed": "2026-08-11T23:15:00.000Z",
      "isAdjustedOdds": false,
      "isAdjustedLine": false,
      "adjustedRisk": null,
      "clvPct": null,
      "createdAt": "2026-08-26T20:35:17.972Z",
      "updatedAt": "2026-08-26T20:35:17.972Z",
      "currencyCode": "USD",
      "BetType": { "id": 1, "typeName": "Straight" },
      "BetStatus": { "id": 2, "statusName": "Closed" },
      "Site": { "id": 1589, "name": "NoVig" },
      "Subbets": [
        {
          "id": 13345,
          "userId": 4,
          "subbetType": "Moneyline",
          "position": "New York Mets",
          "value": 0,
          "oddsAmerican": 114,
          "duration": null,
          "startDate": "2026-08-11T23:15:00.000Z",
          "wasLiveBet": false,
          "description": "Atlanta Braves vs New York Mets - NYM",
          "scrapeDescription": "MLB | Atlanta Braves vs New York Mets | MONEY | NYM",
          "metric": null,
          "createdAt": "2026-08-26T20:35:17.972Z",
          "updatedAt": "2026-08-26T20:35:17.972Z",
          "TruthTeam": { "id": 1020, "name": "New York Mets", "displayName": "New York Mets", "oddsJamId": "1020", "espnId": "21" },
          "OppTruthTeam": { "id": 1003, "name": "Atlanta Braves", "displayName": "Atlanta Braves", "oddsJamId": "1003", "espnId": "15" },
          "Player": null,
          "OppPlayer": null,
          "Event": {
            "id": 428,
            "name": null,
            "startDate": "2026-08-11T23:15:00.000Z",
            "exactStartTime": null,
            "type": "Game",
            "player1Id": null,
            "player2Id": null,
            "homeTeamId": 1003,
            "awayTeamId": 1020,
            "status": "Scheduled",
            "parentEventId": null,
            "sportId": 1,
            "leagueId": 2,
            "description": null,
            "oddsJamId": "428",
            "espnId": "401234567",
            "Player1": null,
            "Player2": null,
            "HomeTeam": { "id": 1003, "name": "Atlanta Braves", "displayName": "Atlanta Braves", "oddsJamId": "1003", "espnId": "15" },
            "AwayTeam": { "id": 1020, "name": "New York Mets", "displayName": "New York Mets", "oddsJamId": "1020", "espnId": "21" },
            "ParentEvent": null,
            "Sport": { "id": 1, "name": "Baseball" },
            "League": { "id": 2, "name": "MLB" }
          },
          "BetResult": { "id": 2, "name": "Lost" },
          "Sport": { "id": 1, "name": "Baseball" },
          "League": { "id": 2, "name": "MLB" }
        }
      ]
    }
  ],
  "nextCursor": "eyJpZCI6OTUzMX0",
  "hasMore": true
}

Bets

List settled bets

Return the connected user's closed and cancelled bets using cursor-based pagination.

GET/oauth2/bets/settled

Authentication

OAuth user accessBearer token + client ID

Owner onlyClient ID + secret

Required scopebets.settled.read

If neither dateClosedAfter nor dateClosedBefore is supplied, all available settled-bet history is considered. The after boundary is inclusive and the before boundary is exclusive. A null nextCursor and hasMore: false indicate that paging is complete.

Request query parameters

Field	Type	Description
`dateClosedAfter`	string	Optional inclusive lower bound for settlement time, as an ISO 8601 datetime. Omit to include the earliest available settled bets.
`dateClosedBefore`	string	Optional exclusive upper bound for settlement time, as an ISO 8601 datetime. Omit to include the latest available settled bets.
`cursor`	string	Opaque nextCursor from the previous response. Omit for the first page; reuse the same date filters when requesting the next page.

Response

200 · application/json

Field	Type	Description
`nextCursor`	string \| null	Pass this opaque value as cursor on the next request. Null means paging is complete.
`hasMore`	boolean	True when another page is available. Equivalent to nextCursor being non-null.
	Bet	A bet in descending ID order for the connected Juice Reel user.

Request

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/bets/settled?cursor=${NEXT_CURSOR}" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

Owner request · client credentials

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/bets/settled?cursor=${NEXT_CURSOR}" \
  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

200 response

JSON

{
  "bets": [
    {
      "id": 9531,
      "userId": 4,
      "oddsAmerican": 114,
      "amountRisked": 0.5886,
      "toWin": 0.6714,
      "netResult": -0.5886,
      "result": "Lost",
      "datePlaced": "2026-08-11T13:32:26.434Z",
      "dateClosed": "2026-08-11T23:15:00.000Z",
      "isAdjustedOdds": false,
      "isAdjustedLine": false,
      "adjustedRisk": null,
      "clvPct": null,
      "createdAt": "2026-08-26T20:35:17.972Z",
      "updatedAt": "2026-08-26T20:35:17.972Z",
      "currencyCode": "USD",
      "BetType": { "id": 1, "typeName": "Straight" },
      "BetStatus": { "id": 2, "statusName": "Closed" },
      "Site": { "id": 1589, "name": "NoVig" },
      "Subbets": [
        {
          "id": 13345,
          "userId": 4,
          "subbetType": "Moneyline",
          "position": "New York Mets",
          "value": 0,
          "oddsAmerican": 114,
          "duration": null,
          "startDate": "2026-08-11T23:15:00.000Z",
          "wasLiveBet": false,
          "description": "Atlanta Braves vs New York Mets - NYM",
          "scrapeDescription": "MLB | Atlanta Braves vs New York Mets | MONEY | NYM",
          "metric": null,
          "createdAt": "2026-08-26T20:35:17.972Z",
          "updatedAt": "2026-08-26T20:35:17.972Z",
          "TruthTeam": { "id": 1020, "name": "New York Mets", "displayName": "New York Mets", "oddsJamId": "1020", "espnId": "21" },
          "OppTruthTeam": { "id": 1003, "name": "Atlanta Braves", "displayName": "Atlanta Braves", "oddsJamId": "1003", "espnId": "15" },
          "Player": null,
          "OppPlayer": null,
          "Event": {
            "id": 428,
            "name": null,
            "startDate": "2026-08-11T23:15:00.000Z",
            "exactStartTime": null,
            "type": "Game",
            "player1Id": null,
            "player2Id": null,
            "homeTeamId": 1003,
            "awayTeamId": 1020,
            "status": "Scheduled",
            "parentEventId": null,
            "sportId": 1,
            "leagueId": 2,
            "description": null,
            "oddsJamId": "428",
            "espnId": "401234567",
            "Player1": null,
            "Player2": null,
            "HomeTeam": { "id": 1003, "name": "Atlanta Braves", "displayName": "Atlanta Braves", "oddsJamId": "1003", "espnId": "15" },
            "AwayTeam": { "id": 1020, "name": "New York Mets", "displayName": "New York Mets", "oddsJamId": "1020", "espnId": "21" },
            "ParentEvent": null,
            "Sport": { "id": 1, "name": "Baseball" },
            "League": { "id": 2, "name": "MLB" }
          },
          "BetResult": { "id": 2, "name": "Lost" },
          "Sport": { "id": 1, "name": "Baseball" },
          "League": { "id": 2, "name": "MLB" }
        }
      ]
    }
  ],
  "nextCursor": "eyJpZCI6OTUzMX0",
  "hasMore": true
}

Bets

List changed bets

Return the connected user's open and settled bets together in one cursor-paginated feed for reconciliation.

GET/oauth2/bets/changed

Authentication

OAuth user accessBearer token + client ID

Owner onlyClient ID + secret

Required scopebets.open.read + bets.settled.read

Results include open, closed, and cancelled bets with no status filter. They are ordered by updatedAt descending, with bet ID descending as the tie-breaker. Use updatedAtAfter as an inclusive ISO 8601 lower bound when reconciling from a checkpoint. Store the newest updatedAt checkpoint from each page and stop when a returned bet is older than your stored checkpoint. Use nextCursor and hasMore for pagination; the cursor is opaque and must not be modified.

Request query parameters

Field	Type	Description
`updatedAtAfter`	string	Optional inclusive lower bound for updatedAt, as an ISO 8601 timestamp. Only bets updated at or after this time are returned.
`cursor`	string	Opaque nextCursor from the previous response. Omit for the first page; reuse it until hasMore is false.

Response

200 · application/json

Field	Type	Description
`nextCursor`	string \| null	Pass this opaque value as cursor on the next request. Null means paging is complete.
`hasMore`	boolean	True when another page is available. Equivalent to nextCursor being non-null.
	Bet	A bet in descending ID order for the connected Juice Reel user.

Request

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/bets/changed?cursor=${NEXT_CURSOR}" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

Owner request · client credentials

cURL

curl --request GET \
  --url "https://external-api.juicereel.com/oauth2/bets/changed?cursor=${NEXT_CURSOR}" \
  --user "${OAUTH_CLIENT_ID}:${OAUTH_CLIENT_SECRET}" \
  --header "X-OAuth-Client-Id: ${OAUTH_CLIENT_ID}"

200 response

JSON

{
  "bets": [
    {
      "id": 9531,
      "userId": 4,
      "oddsAmerican": 114,
      "amountRisked": 0.5886,
      "toWin": 0.6714,
      "netResult": -0.5886,
      "result": "Lost",
      "datePlaced": "2026-08-11T13:32:26.434Z",
      "dateClosed": "2026-08-11T23:15:00.000Z",
      "isAdjustedOdds": false,
      "isAdjustedLine": false,
      "adjustedRisk": null,
      "clvPct": null,
      "createdAt": "2026-08-26T20:35:17.972Z",
      "updatedAt": "2026-08-26T20:35:17.972Z",
      "currencyCode": "USD",
      "BetType": { "id": 1, "typeName": "Straight" },
      "BetStatus": { "id": 2, "statusName": "Closed" },
      "Site": { "id": 1589, "name": "NoVig" },
      "Subbets": [
        {
          "id": 13345,
          "userId": 4,
          "subbetType": "Moneyline",
          "position": "New York Mets",
          "value": 0,
          "oddsAmerican": 114,
          "duration": null,
          "startDate": "2026-08-11T23:15:00.000Z",
          "wasLiveBet": false,
          "description": "Atlanta Braves vs New York Mets - NYM",
          "scrapeDescription": "MLB | Atlanta Braves vs New York Mets | MONEY | NYM",
          "metric": null,
          "createdAt": "2026-08-26T20:35:17.972Z",
          "updatedAt": "2026-08-26T20:35:17.972Z",
          "TruthTeam": { "id": 1020, "name": "New York Mets", "displayName": "New York Mets", "oddsJamId": "1020", "espnId": "21" },
          "OppTruthTeam": { "id": 1003, "name": "Atlanta Braves", "displayName": "Atlanta Braves", "oddsJamId": "1003", "espnId": "15" },
          "Player": null,
          "OppPlayer": null,
          "Event": {
            "id": 428,
            "name": null,
            "startDate": "2026-08-11T23:15:00.000Z",
            "exactStartTime": null,
            "type": "Game",
            "player1Id": null,
            "player2Id": null,
            "homeTeamId": 1003,
            "awayTeamId": 1020,
            "status": "Scheduled",
            "parentEventId": null,
            "sportId": 1,
            "leagueId": 2,
            "description": null,
            "oddsJamId": "428",
            "espnId": "401234567",
            "Player1": null,
            "Player2": null,
            "HomeTeam": { "id": 1003, "name": "Atlanta Braves", "displayName": "Atlanta Braves", "oddsJamId": "1003", "espnId": "15" },
            "AwayTeam": { "id": 1020, "name": "New York Mets", "displayName": "New York Mets", "oddsJamId": "1020", "espnId": "21" },
            "ParentEvent": null,
            "Sport": { "id": 1, "name": "Baseball" },
            "League": { "id": 2, "name": "MLB" }
          },
          "BetResult": { "id": 2, "name": "Lost" },
          "Sport": { "id": 1, "name": "Baseball" },
          "League": { "id": 2, "name": "MLB" }
        }
      ]
    }
  ],
  "nextCursor": "eyJpZCI6OTUzMX0",
  "hasMore": true
}

Usage

Rate limits

API requests are limited in five-minute buckets.

1,000 requestsPer IP address per five-minute bucket

25,000 requestsPer client ID per five-minute bucket

Need a higher limit? Email support@juiceintegration.com.

Errors

Common error responses

Resource errors use an error field. OAuth protocol errors use error and error_description.

400X-OAuth-Client-Id header is required

Every external API request must identify its OAuth client.

400cursor is invalid

The supplied bet cursor is malformed or was not issued by Juice Reel.

400invalid_request / invalid_grant

OAuth form fields are malformed, the code is expired or consumed, PKCE failed, or the refresh token is invalid.

401Invalid OAuth access token

The bearer token is missing, expired, revoked, belongs to another client, or its grant is no longer active.

401invalid_client

Client ID, client secret, or HTTP Basic authentication is invalid.

403The access token requires the requested scope

The grant does not contain the scope required by this resource.

403Only the OAuth client owner can access this resource

The subscribers endpoint may only be called with a token issued for the user who owns the OAuth application.

429Rate limit exceeded

The IP address or OAuth client ID has exceeded its five-minute request limit. Wait for the bucket to reset before retrying.

5xxInternal server error

A transient server failure occurred. Retry idempotent GET requests with exponential backoff.

Webhooks

How webhooks work

Webhooks let your server receive real-time events from Juice Reel without polling for updates.

Juice Reel sends an HTTP POST request to your configured destination endpoint with the data for the event bucket you selected. Verify the signature against the raw request body before parsing or processing the event, then return a successful 2xx response after accepting it.

Webhook flow

1. ConfigureAdd a destination endpoint and choose the event bucket it should receive.

2. ReviewJuice Reel reviews the endpoint before delivery begins.

3. ReceiveAccept signed POST requests and process each event on your server.

Verify the HMAC signature

Node.js

import express from "express";
import crypto from "node:crypto";

const app = express();

function verifyJuiceReelWebhook(rawBody, signature, secret) {
  const expected = "sha256=" + crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  const received = Buffer.from(signature, "utf8");
  const computed = Buffer.from(expected, "utf8");

  return received.length === computed.length
    && crypto.timingSafeEqual(received, computed);
}

app.post(
  "/webhooks/juice-reel",
  express.raw({ type: "application/json" }),
  (req, res) => {
    const signature = req.get("X-Juice-Reel-Signature");
    const secret = process.env.JUICE_REEL_WEBHOOK_SIGNING_SECRET;

    if (!signature || !secret || !verifyJuiceReelWebhook(req.body, signature, secret)) {
      return res.sendStatus(401);
    }

    // Parse only after the HMAC has been verified.
    const event = JSON.parse(req.body.toString("utf8"));
    console.log("Juice Reel event:", event.type, event.data);
    return res.sendStatus(204);
  },
);

Webhooks

Subscription events

Receive real-time updates when a subscriber purchases, renews, or cancels a subscription.

Subscription event forwarding is in its early stages. It is recommended that you pair this with the REST API /oauth2/subscribers/current. This will help you keep an accurate log of users that are currently subscribed. We do not currently support retrying webhooks. This means that if your server goes down or a webhook is missed, your database may not accurately reflect your true subscriptions state. It is recommended to use this for realtime access updates but run a nightly job that reconciles your subscriber consensus table against the REST API.

Events

Event type	When it is sent
	A user completes an initial subscription purchase.
	An existing subscription successfully renews.
	A subscription is cancelled or will not renew.
	A subscription reaches its expiration date and access ends.

Payload fields

Field	Type	Description
`id`	string	Unique identifier for this webhook event.
`type`	string	The subscription event type selected in the event list above.
`createdAt`	datetime	ISO 8601 timestamp for when Juice Reel created the event.
	object	Subscription details associated with the event.

Request headers

The signature uses the signing secret shown once when you create the webhook endpoint.

Content-Typeapplication/json

X-Juice-Reel-Signaturesha256=<hex digest>

SUBSCRIPTION_RENEWED payload

JSON

{
	"id": "evt_01JQ8Y7H2M6V4K9P3B1D0A5C8F",
  "type": "SUBSCRIPTION_RENEWED",
  "createdAt": "2026-09-17T16:00:00.000Z",
  "data": {
    "subscriberUserId": 12345,
    "subscriptionProductId": "juice_plus_monthly",
    "subscriptionDuration": "MONTHLY",
    "isFreeTrial": false,
    "revenueCentsUsd": 999,
    "expiresDate": "2026-10-17T16:00:00.000Z",
    "isCurrentlySubscribed": true
  }
}