Base URL: https://api.54-237-170-237.sslip.io The Mobile REST API is a convenience layer over JSON-RPC. It handles:
  • Device registration + liveness
  • Engagement submission (builds the oracle calldata for you)
  • Profile + leaderboard reads
  • Rewards preview
All endpoints accept and return JSON, CORS-open on testnet.

​
Typical flow

1

On app launch — register the device

POST /api/mobile/register
2

Periodic heartbeat while app is foreground/online

POST /api/mobile/heartbeat every 30–60s.
3

On user action — submit engagement

POST /api/mobile/engagement. Server returns a txHash and reward preview.
4

Poll profile + action history for UI

GET /api/mobile/profile/:address and GET /api/mobile/actions/:address.

​
Endpoint index

​
OpenAPI

The full spec is at docs/youthchain-api.yaml and a Postman collection at docs/youthchain-postman.json. Both are distributed alongside this documentation.