Mini Games

Make your portal the go-to place to call the score this game season.

Clients pick the result and the exact score on every match you publish. Correct calls pay coins and XP, so every match day gives them a reason to log in.

Matchday 2 Prediction
Time left to predict result
01days:00hrs:23min:46sec
v
Settled
Brazil v JapanMon 09:00
Their call2 - 1
Final2 - 1
Paid out
v
Settled
France v ItalyMon 18:00
Their call1 - 0
Final0 - 0
v
Open now
Germany v NetherlandsWed 20:45
Their call2 - 2
v
Locked
Belgium v DenmarkThu 17:30
Their call1 - 2
v
Opens Wednesday
Poland v UkraineThu 20:00
Their callNot called
Rewards
Correct Winning Team50XP100
Correct Score100XP200
A deadline you setLocks by kickoffCoins and XP on a correct callRun it from your system or ours
EXAMPLE MATCH. VALUES AND TEAMS ARE ILLUSTRATIVE.
The window

Keep the rewards going all season, and give clients a reason to return.

3 distinct settings that schedule match predictions around live games. Open calls days ahead and close them before kickoff. Clients get rewards based on the accuracy of their predictions.

Mon 1 Jun · 09:00

Prediction start

Before predictions open, clients see the scheduled match with a countdown to the moment they can submit predictions.

Sun 7 Jun · 23:59

Prediction end

The prediction window closes. No more predictions may be made after this point.

Group Stage, Matchday 2
Brazil
VS
Japan
Mon, Jun 1509:00 GMT+9
Correct Winning Team50 XP100
Correct Score100 XP200
Prediction begins in:
Days
:
Hours
:
Minutes
:
Seconds
View Details
Mon 15 Jun · 09:00

Kickoff

Signals an ongoing match with a countdown to when results will be released.

Mon 15 Jun · 11:05

Settled

Results are entered and accurate predictions get paid out.

Setup

Create predictions for any two-team match.

Name the match, choose two teams, set the prediction times and publish. All 48 World Cup nations are built in, and you can add your own teams.

Match Title

Your own name for the match, which is what clients see at the top of the card.

Team A / Team B

Chosen from the preset list or from teams you have made yourself.

Description

Rich text, for the rules or the context you want beside the match.

Score basis

Whether extra time counts toward the exact score.

View Permission

Which tiers and roles can see this match.

Each match publishes and unpublishes on its own, so one can be pulled without touching the others.

BackEdit Match Prediction
...Publish
Careful! You have unsaved changesResetSave Changes
Match Setup
Match Title
New Match Prediction
Team A
Select team
Team B
Select team
Prediction start
--
Prediction end
--
Kickoff
--
Description
BIUAlinkEnter description here
Score basis
--
View Permission
--
SettlementINACTIVEPublish the match to make it visible to traders. Settlement options will appear once predictions are open.

Admin screen redrawn from the product. Example match; values are illustrative.

Rewards

Two different ways that clients can win.

Two reward tiers on one call: one for the correct result and a bonus for the exact final score. An exact-score call pays both.

Match Prediction

Who wins?

Call the score

Score is judged based on the result including extra time.

Brazil
2
—
Japan
1
Brazil
Final-Score
21
Japan

Perfect call! You earned

+0+0XP

Your prediction: Brazil win 2 – 1

Correct result10050XPExact-score bonus200100XP
Custom Rewards

Each tier pays out in either coins or XP.

Entry costCoins per submission 0

Decide if clients can play for free, or if entering a prediction costs them coins.

In the same currency

Coins that are paid out can be used in your rewards store. XP is used to rise through the ranks.

The record

Trace every match and every call placed.

Each match is logged and easily traceable, downloadable and ready for your compliance team.

Brazil v Japan2-1SettledMon 15 Jun, 11:05
Export
ParticipantCallOutcomeCoinsXP
Ro H.2-1Exact score+300+150
Marcus A.3-1Correct result+100+50
Yuki T.1-2No payout----
Priya N.2-1Exact score+300+150
Tom B.2-0Correct result+100+50
Elena V.0-0No payout----
Sam K.3-2Correct result+100+50
Aisha R.2-1Exact score+300+150
0of 1,240 entriesExact score96Correct result412Paid70,000 coins35,000 XP

The same record is available to a system you run yourself: the API reads back the winners, and every participant with the call they made and the payout they received.

Go live

Easily Embedded into your Client Portal.

Whichever way you run the matches, clients play them in the same widget. Your developers install the SDK, import it, and place the widget in your portal.

  1. 1
    Terminal

    Install

    Add the widget SDK to your project with one command.

    $npm install @returningai/widget-sdk
  2. 2
    app.ts

    Import

    Import it once, in your app’s entry point.

    1import '@returningai/widget-sdk'
  3. 3
    Your client portal

    Embed

    Place the widget in your portal. A short-lived token from your backend signs each client in.

    Match Predictionembed-token ← your backend

Simplified. The widget ID comes from your dashboard and the access token from your backend.

Automation

Automate Match Setups with one Simple API Workflow.

If you already have match data, your system can create, publish and settle matches through the API instead, bypassing the need to enter them by hand.

01
Your system calls the API

The API creates, updates, publishes, settles and voids matches.

calls
create · update · publish · settle · void
02
Many matches at once?

A bulk update changes up to a hundred in one request.

yes
one bulk update, up to 100
03
Settlement finished yet?

Settlement answers at once with a settling state, and your system reads the result back when it finishes.

not yet
202 settling now, read back later
04
Same request sent again?

Create, settle and void take an idempotency key, so a retry returns the original answer instead of running twice.

yes
the original answer, not run twice
05
Version still current?

Updates carry the version they read, so a write based on an old version is refused.

no
409, the newer edit stays
06
Webhook triggers

Name a trigger that fires when a client submits a call, a match settles, or both. It then appears in your workflows.

fires
Custom Workflowworkflow starts

The API’s behavior, simplified. The status codes are the ones it returns.

Eligibility

The controls a compliance review will ask about.

Set each match’s audience, entry cost, rewards and publishing on its own, for your compliance team to review.

Fixed by the product

A prediction window cannot end after kickoff. The form refuses to save one, so no call can be entered on a match that is already under way.

One call per client. Once a prediction is submitted, it cannot be changed or entered again.

Kickoffstart
Prediction end
Prediction end time cannot be after kickoff7 Jun 2026 · 23:59 · kickoff 15 Jun 09:00
Set by you, per match
View Permission
Tier 1Tier 2Tier 3VIP role

Which tiers and roles see it.

Entry cost
Coins per submission
off by default

Whether entering costs coins.

Correct result tier
100 coins50 XP+ Add custom reward

What a correct call is worth, and in what.

Publish
UnpublishedPublished

Whether it is published at all.

These describe the controls the product gives you. Whether a program is permitted for a given entity stays your compliance team’s decision.

Live Deployment Data

Games keep traders engaged. Engaged traders are worth more.

Nine months at a broker using Returning.AI, traders who used the loyalty program against a matched group who didn't.

See the full results
+$2,160More revenue per trader
2×Trader retention
1.8×ARPU
With loyaltyWithout loyaltyCumulative revenue per trader
Match Prediction

Give your clients a match worth coming back for.

Set up match predictions so game season gives clients a reason to visit your portal, with rewards and payouts your compliance team has approved.

Trusted by Axi, Vantage Markets, Infinox, ADSS, GNT Capital, M4Markets, GTCFX, IronFX, Vault Markets, NextTrade, Xlence, IC Funded, Atmos Funded, and more.

Plan your deployment
  • Client portal and data connection
  • Program rules and reward choices
  • Entity and regional eligibility
  • Reward delivery responsibilities
  • Support and service terms