Freecash 数据 API:金币钱包、任务与提现
《Freecash: Earn Money》是柏林 Almedia GmbH(Koppenstr. 8, 10243)的 Android 客户端,该公司自 2020 年起按玩游戏、填问卷和试用产品向用户发奖励。用户用 Google、Facebook 或约一分钟的邮箱注册登录后,挑选任务、完成列出的步骤,再通过银行转账、PayPal、Venmo、100 多种礼品卡(Amazon、Apple、Google Play、Visa 预付卡)或比特币、以太坊、莱特币等加密货币提现。Play 商店约 56.3 万条评价、评分 4.6,安装量逾一千万,分级 Mature 17+,最近更新于 2026 年 10 月 8 日(客户端 1.36);官网自称逾 8,000 万用户,Trustpilot 约 32 万条评价、评分 4.6。Android 壳在 Chrome Custom Tab 中打开 Freecash 网页应用,并内嵌 Adjoe、Fyber 与 Tapjoy 积分墙。它更接近 Swagbucks 一类有奖任务应用,而不是银行或钱包。
金币钱包把可花的 balance 与 unwithdrawableBalance、withdrawableSoon 拆开,同一条 me 行还带累计 totalWithdrawn、推广 refBalance 与 pendingAffiliateRewards,以及 gainId、uid、username、signupCountry、kycVerificationStatus 和 idVerificationStatus。活动金币落在旁路钱包:bonusBalance 对已可提现的 bonusWithdrawableCoins。
提现配置返回 minWithdrawableCoins 和已保存的 defaultMethod(slug/title,如 paypal 或 amazon-gift-card)。赚钱信息流分页 offerName、coins 与 dateToRelease;奖池轮次给出奖池 reward、座位 position,历史行则带 betAmount、rewardAmount 与 chance。资金系统用这些通道对回单;产能分析把任务金币接到冻结切片;合规在 KYC 未过时隐藏提现;运营用奖池期望值对冲金币消耗。openData Studio 把同一组字段变成可调用的开放数据。
应用截图
API 端点一览
请求/响应示例为依据应用界面重构的示意示例,并非实时抓包。
初始化会话 JWT
POST
/fc-api/auth/jwt/initosint在 Custom Tabs 会话就绪后签发 Bearer JWT,供后续 me、提现、任务与奖池 GraphQL 调用使用。
认证方式: 网页应用里 Google / Facebook / 邮箱登录留下的会话 Cookie。返回后续 GraphQL 以 Authorization: Bearer 携带的 JWT;/fc-api/auth/jwt/refresh 失败且 401 时会回落到本路径。
- ok
- token
- expiresIn
POST /fc-api/auth/jwt/init HTTP/1.1 Accept: application/json Content-Type: application/json Cookie: fc_session=<session> {}{ "ok": true, "token": "eyJhbGciOi...", "expiresIn": 3600 }登录用户与金币钱包
POST
/fc-api/graphqlopenfinance水合资料页与金币角标:可花 balance 对 unwithdrawableBalance、累计 totalWithdrawn、推广 refBalance,以及 KYC 标记。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT,外加 Freecash 会话 Cookie。operationName=getCurrentUserInfo。
- me
- uid
- gainId
- username
- balance
- unwithdrawableBalance
- withdrawableSoon
- totalWithdrawn
- refBalance
- pendingAffiliateRewards
- signupCountry
- countryCode
- kycVerificationStatus
- idVerificationStatus
- xp
- level
- refcode
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en Cookie: fc_session=<session> { "operationName": "getCurrentUserInfo", "query": "query getCurrentUserInfo { me { uid gainId username email balance unwithdrawableBalance withdrawableSoon totalWithdrawn refBalance pendingAffiliateRewards signupCountry kycVerificationStatus idVerificationStatus xp level refcode } }" }{ "data": { "me": { "uid": "u-88421", "gainId": "G-229184", "username": "maya.k", "email": "[email protected]", "emailConfirmed": true, "avatar": "https://cdn.freecash.com/avatars/maya.png", "balance": 18450, "unwithdrawableBalance": 320, "withdrawableSoon": 900, "totalWithdrawn": 126000, "refBalance": 450, "pendingAffiliateRewards": 120, "signupCountry": "US", "location": { "countryCode": "US" }, "kycVerificationRequired": false, "kycVerificationStatus": "verified", "idVerificationStatus": "not_required", "idVerification": { "idVerificationRequired": false, "idVerificationProvider": "persona", "idVerificationStarted": false, "reason": null }, "xp": 12840, "level": 12, "refcode": "MAYA8", "verified": true, "twoFactorEnabled": false, "hasLinkedOffer": true, "datejoined": "2024-03-11T18:02:00Z" } } }提现设置与最低金币
POST
/fc-api/graphqlopenfinance加载提现页门槛 minWithdrawableCoins,以及已保存的 defaultMethod slug/title(PayPal、Venmo、礼品卡、加密货币)。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT。operationName=GetWithdrawalSettings。
- getWithdrawalSettings
- defaultMethod
- slug
- title
- cashoutGoalEnabled
- minWithdrawableCoins
- showCashoutGoalOnOfferStart
- signupBonusCoins
- signupBonusEnalbed
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en { "operationName": "GetWithdrawalSettings", "query": "query GetWithdrawalSettings { getWithdrawalSettings { defaultMethod { slug title } cashoutGoalEnabled minWithdrawableCoins showCashoutGoalOnOfferStart signupBonusCoins signupBonusEnalbed } }" }{ "data": { "getWithdrawalSettings": { "defaultMethod": { "slug": "paypal", "title": "PayPal" }, "cashoutGoalEnabled": true, "minWithdrawableCoins": 2500, "showCashoutGoalOnOfferStart": true, "signupBonusCoins": 50, "signupBonusEnalbed": true } } }设置默认提现通道
POST
/fc-api/graphqlopenfinance把用户选中的提现通道(paypal、venmo、amazon-gift-card、bitcoin 等)存为 defaultMethodSlug。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT。mutation 为 setWithdrawalMethod。
- setWithdrawalMethod
- defaultMethodSlug
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en { "query": "mutation ($defaultMethodSlug: String!) { setWithdrawalMethod(defaultMethodSlug: $defaultMethodSlug) }", "variables": { "defaultMethodSlug": "amazon-gift-card" } }{ "data": { "setWithdrawalMethod": true } }列出排期任务
POST
/fc-api/graphqlopendata分页 earn/offers 目录:offerName、金币奖励与排期任务的 dateToRelease。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT。earn/offers 信息流上的 findOffersByQuery。
- findOffersByQuery
- totalAmount
- totalItemsCount
- offerName
- icon
- dateToRelease
- dayToRelease
- coins
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en { "query": "query { findOffersByQuery(isScheduled: true, isChargeback: false, sort: \"dateToRelease\", order: ASC, held: 1, limit: 100) { meta { totalAmount totalItemsCount } items { offerName icon dateToRelease dayToRelease coins } } }" }{ "data": { "findOffersByQuery": { "meta": { "totalAmount": 42800, "totalItemsCount": 36 }, "items": [ { "offerName": "Raid Shadow Legends — reach HQ 8", "icon": "https://cdn.freecash.com/offers/raid.png", "dateToRelease": "2026-10-18T00:00:00Z", "dayToRelease": 1, "coins": 4500 } ] } } }奖励金币钱包
POST
/fc-api/graphqlopenfinance与主钱包分开读取活动/每日奖励金币:bonusBalance 以及对已可提现的 bonusWithdrawableCoins。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT。bonusBalanceAndFulfilment 查询(userRewardsApi)。
- bonusBalanceAndFulfilment
- bonusBalance
- bonusWithdrawableCoins
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en { "query": "query { bonusBalanceAndFulfilment { bonusBalance bonusWithdrawableCoins } }" }{ "data": { "bonusBalanceAndFulfilment": { "bonusBalance": 180, "bonusWithdrawableCoins": 50 } } }进行中的奖池
POST
/fc-api/graphqlopendata加载进行中的奖池轮次:奖池 reward、模板投注上下限,以及带 gainId 的 userBets 座位。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT。jackpot 界面上的 jackpots 查询。
- jackpots
- id
- bet
- status
- reward
- template
- minBet
- maxBet
- maxUsersCount
- userBets
- position
- gainId
- username
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en { "query": "query { jackpots { id bet status reward completedAt template { id type minBet maxBet maxUsersCount minUserBet maxUserBet } userBets { id country bet position status user { gainId username avatar } } } }" }{ "data": { "jackpots": [ { "id": 8841, "bet": 250, "status": "OPEN", "reward": 50000, "completedAt": null, "createdAt": "2026-10-17T12:00:00Z", "updatedAt": "2026-10-17T15:40:00Z", "template": { "id": 12, "type": "WHEEL", "minBet": 50, "maxBet": 500, "maxUsersCount": 200, "minUserBet": 50, "maxUserBet": 500 }, "userBets": [ { "id": 99102, "country": "US", "bet": 250, "position": 3, "status": "ACTIVE", "user": { "gainId": "G-229184", "username": "maya.k", "avatar": "https://cdn.freecash.com/avatars/maya.png" } } ] } ] } }下注奖池
POST
/fc-api/graphqlopenfinance花费金币坐上 jackpotId 的 position 座位,对应奖池转盘选座写入。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT。mutation jackpotBet(position, jackpotId)。
- jackpotBet
- position
- jackpotId
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en { "query": "mutation ($position: Int!, $jackpotId: Int!) { jackpotBet(position: $position, jackpotId: $jackpotId) }", "variables": { "position": 3, "jackpotId": 8841 } }{ "data": { "jackpotBet": true } }我的奖池下注
POST
/fc-api/graphqlopenfinance分页登录用户的奖池历史:每笔 jackpotId 的 betAmount、rewardAmount、chance 与 status。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT。operationName=jackpotMyBets。
- jackpotMyBets
- gainId
- betAmount
- jackpotId
- rewardAmount
- jackpotBudget
- completedAt
- chance
- status
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en { "operationName": "jackpotMyBets", "variables": { "page": 1, "limit": 20, "sort": "COMPLETED_AT_DESC", "endDate": "2026-10-17T23:59:59Z", "status": "COMPLETED" }, "query": "query jackpotMyBets($page: Int!, $limit: Int!, $sort: JackpotWinnersSortEnum!, $endDate: DateTime!, $status: JackpotBetStatStatusEnum) { jackpotMyBets(endDate: $endDate, sort: $sort, maxChance: 100, page: $page, limit: $limit, status: $status) { items { gainId betAmount jackpotId rewardAmount jackpotBudget completedAt chance status } } }" }{ "data": { "jackpotMyBets": { "items": [ { "gainId": "G-229184", "betAmount": 250, "jackpotId": 8841, "rewardAmount": 0, "jackpotBudget": 50000, "completedAt": "2026-10-16T21:04:00Z", "chance": 4.2, "status": "COMPLETED" } ] } } }奖池赢家榜
POST
/fc-api/graphqlopendata分页公开奖池赢家:每个已结束 jackpotId 的 username、avatar、rewardAmount 与 chance。
认证方式: POST /fc-api/auth/jwt/init 签发的 Bearer JWT。operationName=jackpotWinners。
- jackpotWinners
- gainId
- betAmount
- jackpotId
- rewardAmount
- jackpotBudget
- username
- avatar
- completedAt
- chance
POST /fc-api/graphql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json X-Locale: en { "operationName": "jackpotWinners", "variables": { "page": 1, "limit": 20, "sort": "COMPLETED_AT_DESC", "endDate": "2026-10-17T23:59:59Z" }, "query": "query jackpotWinners($page: Int!, $limit: Int!, $sort: JackpotWinnersSortEnum!, $endDate: DateTime!) { jackpotWinners(page: $page, limit: $limit, sort: $sort, endDate: $endDate, maxChance: 100) { items { gainId betAmount jackpotId rewardAmount jackpotBudget username avatar completedAt chance } } }" }{ "data": { "jackpotWinners": { "items": [ { "gainId": "G-11002", "betAmount": 400, "jackpotId": 8830, "rewardAmount": 50000, "jackpotBudget": 50000, "username": "leo.p", "avatar": "https://cdn.freecash.com/avatars/leo.png", "completedAt": "2026-10-16T21:04:00Z", "chance": 6.1 } ] } } }上报移动端追踪标识
POST
/fc-api/mobile-analytics/store-tracking-infoosint把设备 GAID 与 CleverTap id 记到 Android 客户端,供后续任务归因关联到登录用户。
认证方式: Android 客户端上的静态 x-api-key 请求头。启动后携带广告 ID 上报,不依赖 Custom Tabs 会话。
- gaid
- appType
- clevertapId
POST /fc-api/mobile-analytics/store-tracking-info HTTP/1.1 x-api-key: e7b4e769-0eb5-42ea-a1c0-6fadd3fb03d0 Content-Type: application/json { "gaid": "38400000-8cf0-11bd-b23e-10b96e40000d", "appType": "android", "clevertapId": "-n9a8b7c6d" }{ "ok": true }
数据类别
- 用户资料
- 金币余额
- 推广余额
- KYC 与身份核验
- 提现通道
- 任务目录
- 奖励金币
- 奖池轮次
- 奖池下注
- 设备广告标识
数据使用场景与案例
对账 PayPal 与礼品卡提现
资金系统读取 minWithdrawableCoins 与 defaultMethod.slug,再用 me.totalWithdrawn、withdrawableSoon 去匹配 PayPal、Venmo 或 Amazon 礼品卡回单,把已过门槛的提现关单。
比较任务金币与冻结额
把 findOffersByQuery.coins、dateToRelease 与 me.unwithdrawableBalance 关联,看哪些游戏任务仍落在待解冻切片里。
按 KYC 开关提现
合规栈在 kycVerificationStatus 或 idVerification.idVerificationRequired 显示用户还不能把金币转出时,隐藏提现选择器。
用奖池期望值对冲金币消耗
运营看板用 jackpotMyBets.rewardAmount 与 chance 对冲 betAmount,使一轮结算后的期望值仍与 me.balance 对齐。
常见问题
Freecash 的 Android 客户端如何鉴权?
应用在 Chrome Custom Tab 中打开 Freecash 网页。Google、Facebook 或邮箱登录留下会话 Cookie;POST /fc-api/auth/jwt/init 再签发 JWT,后续 GraphQL 以 Authorization: Bearer 携带。续期走 /fc-api/auth/jwt/refresh,401 时回落到 init。
提现页上有哪些通道?
银行转账、PayPal、Venmo、100 多种礼品卡(Amazon、Apple、Google Play、Visa 预付卡)以及比特币、以太坊、莱特币等加密货币。GetWithdrawalSettings 返回 minWithdrawableCoins 和 defaultMethod.slug/title;setWithdrawalMethod 保存用户选中的通道。
登录后的 me 对象返回什么?
getCurrentUserInfo 返回 uid、gainId、username、email、可花 balance、unwithdrawableBalance、withdrawableSoon、totalWithdrawn、refBalance、pendingAffiliateRewards、signupCountry、kycVerificationStatus、idVerificationStatus、xp 与 level。
这是公开的开发者 API 吗?
不是。上面的对象——金币钱包、任务目录、提现通道与奖池下注——是已登录客户端已经展示的数据,按应用功能建模,方便集成方调用同一组字段,并非已发布的开发者计划。
与 Freecash: Earn Money 相似的应用
- Swagbucks — Swagbucks 是 Prodege 于 2008 年上线的积分门户,会员通过购物和其他赚钱活动积累 Swag Bucks,再兑换现金奖励或礼品卡。
- InboxDollars — InboxDollars 是 Freecash 常见对照之一,会员可通过阅读付费邮件、填问卷、玩游戏以及在合作品牌购物来赚现金。
- Survey Junkie — Survey Junkie 是 DISQO 的市场调研社区,会员填问卷后积分满 5 美元即可兑成 PayPal 或银行现金,也可换成 Amazon、Target、Walmart、Starbucks 礼品卡。
- Prolific — Prolific 是付费研究平台,参与者完成问卷、决策游戏和 AI 评估等任务,余额达到 6 美元或 6 英镑即可提现,后续打款走 PayPal。
- Google Opinion Rewards — Google Opinion Rewards 是谷歌的问卷应用,完成短调查后以 Google Play 积分或 PayPal 余额发放奖励。
- Clickworker — Clickworker 是 clickworker GmbH 的自由职业工作台,工人按事先公布的单价完成写作、翻译、检索和数据处理等付费微任务。
- Mistplay — Mistplay 是免费的 Android 与 iOS 应用,用户玩目录里的游戏赚积分,再兑成 Amazon、Visa、Walmart、Google Play 等品牌礼品卡。
- KashKick — KashKick 是 2017 年成立的美国奖励网站,会员玩游戏、填问卷、看优惠和购物,满 10 美元后可通过 PayPal 或礼品卡提现。
相关主题
- Freecash API
- Freecash 金币余额
- minWithdrawableCoins
- PayPal 提现
- offerName coins
- jackpotBet
- gainId
- Almedia GmbH Freecash
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业