Tokens, rewards and limits
This topic describes how tokens are earned and spent on the Exchange, and the limits that apply.
Subscription types
The Exchange provides its users with the following two types of subscription:
Freemium
Pay-per-use model that allows its users to earn and spend tokens, the unit of the Exchange.
Tokens can be earned by uploading fraud events and flagging fraud events and spent on downloading fraud events.
Freemium subscription is available for all registered users and applies all of the rules described in this documentation. The web app shows it as the Free plan.
Premium
Paid model that allows its users to have unlimited access to the fraud data stored on the Exchange. Downloads are not charged in tokens.
A Premium subscription costs 2,000 USD per month or 20,000 USD per year. However, if you require exclusive features and benefits, these can be discussed individually and may affect the base price of the subscription.
To apply for a Premium subscription, write to support@fraudintelligencelimited.com.
Subscription values in the API
The account answer of the API returns the subscription of the company as subscriptionType:
| Value | Meaning | Downloads |
|---|---|---|
FREEMIUM | The Freemium subscription. | Charged in tokens. |
TRIAL | A trial of the Premium subscription. | Not charged. |
PAID | The Premium subscription. | Not charged. |
Uploading fraud events
A company earns tokens for every contribution its users submit.
The following rules apply:
- The reward is counted per fraud identifier. A range of phone numbers or IP addresses is rewarded for every value in the range.
- The reward is set per fraud type and per company type. It is
10tokens per identifier for every fraud type and every company type. The rates in force are returned by the Get the reward tables endpoint. - A record is rewarded once. If the peer already holds an active record with the same fraud identifier and fraud type, uploading it again stores nothing and earns nothing. The same record can be uploaded and rewarded again after the stored one has expired or has been flagged.
- Sending the same upload request again, for example after a timeout, does not store or reward anything twice.
- Every stored record counts towards the upload limit of the peer.
See the following related tutorials:
Flagging fraud events
If a peer finds that a contribution is wrong, a "false positive", it can flag it. Tokens are added to the peer's balance when a contribution is flagged.
The following rules apply:
- The reward is counted per fraud identifier. It is set per fraud type and per company type, and is
10tokens per identifier for every fraud type and every company type. - Flagging a contribution that the peer uploaded itself, or that names it as the original source, earns nothing.
- A contribution can be flagged once. A contribution that is already flagged or has expired cannot be flagged.
- A flagged contribution stays available for download until its expiry date, with its status set to
Flaggedand the identifier of the flagging peer.
See the following related tutorials:
Downloading fraud events
Tokens pay for downloading the fraud events that other companies submitted.
The following rules apply:
- A fraud event is charged the first time a peer downloads it. The price is per identifier: a range costs the price times the number of values in it. Email addresses and URLs cost nothing.
- Downloading a fraud event again is free.
- Downloading the peer's own contributions is free. This covers contributions the peer uploaded and contributions that name it as the source.
- A fraud event that the balance does not cover is not returned. The answer counts it and gives its cost.
- A fraud event can be downloaded until its expiry date, 60 days after it was uploaded, whether it is active or flagged.
For the exact rules, see API reference > Query contributions.
See the following related tutorials:
Token balance
The number of tokens that a company holds, and that can be used to pay for downloading of fraud event data.
Users registered under the same peer share the same token balance. Every movement of the balance is recorded: see Security and data.
A user can check their current token balance in any of the following two ways:
- By calling the Get the token balance endpoint as a signed-in user.
- On the Dashboard or the Profile page of the web app.
Rates in force
| Activity | Reward | Cost |
|---|---|---|
| Uploading fraud events | 10 tokens per fraud identifier | - |
| Flagging fraud events | 10 tokens per fraud identifier | - |
| Downloading fraud events | - | 1 token per fraud identifier |
The rewards are the same for every fraud type and every company type.
The rates are returned by the Get the reward tables and Get the query prices endpoints. The web app shows them on the Dashboard.
Welcome bonus
A new peer (company) receives a welcome bonus of 1,000 tokens when its registration is approved.
The bonus is added once per company, to the balance that all of its users share. Users who join an existing company add no further bonus.
Upload limit
Every peer can store a limited number of records per period: 1,000,000 records per 30 days. The limit is counted in records, not in tokens, and is shared by all users of the peer.
- Every record that an upload stores takes one from the limit. A record that the peer already holds is not stored and takes nothing.
- An upload that would exceed what is left of the limit is refused as a whole: nothing is stored and nothing is rewarded.
- At the end of the period the limit resets in full.
The size of the limit, how much of it is used, the length of the period and the time of the next reset can be checked in any of the following two ways:
- By calling the Get the upload limit endpoint as a signed-in user.
- On the Dashboard or the Profile page of the web app.
WARNING
Fraud Intelligence Limited may from time to time, by an in-advance written email notice to you, adjust the limit, in accordance with the Terms and Conditions.
Usage emails
The company admins receive an email when the company has spent 80 percent of the tokens it had in the month, and when it has used 80 percent of its upload limit for the period. Each email is sent once per period.
Reward split
The reward for an upload can be split between the original source of the fraud data and the uploader of that data.
Contribution records include the optional sourcePeerId field. If an upload names another peer as the source, the reward is split: 10% to the uploader and 90% to the source. If it does not, or names the uploader itself, the reward is allocated to the uploader in full. The source must be a member company. The ratio in force is returned by the Get the reward tables endpoint.
NOTE
Any contribution that has its reward split between the uploader and the original source belongs to both companies: each of them downloads it as its own contribution.