906.sh Documentation

Welcome to the 906.sh developer documentation. Build on top of our modular community currency ecosystem for Michigan's Upper Peninsula.

🔗 API-First

RESTful API powering wallet, barter, tasks, and community features. Build your own apps on our infrastructure.

⛓️ XRPL Native

YOOP token runs on XRP Ledger. Fast, cheap, and decentralized. Mainnet-ready, testnet by default.

🧩 Modular

18 ecosystem modules. Pick what you need. NorthernWISP and DeltaCounty.Services already integrate.

⛈️ Resilient

Storm Mode enables offline transactions via LoRaWAN mesh. Blizzard-proof money.

Quickstart

Get started with the 906.sh API in minutes.

Base URL

https://api.906.sh

Check API Status

curl https://api.906.sh/health

Get Network Stats

curl https://api.906.sh/api/network/stats

Returns:

{
  "totalUsers": 100,
  "totalTransactions": 500,
  "activeCounties": 5,
  "yoopUsdRate": 0.10,
  "network": "testnet"
}

Authentication

Most endpoints require JWT authentication. Include the token in the Authorization header:

Authorization: Bearer <accessToken>

Register

POST /api/auth/register
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "securepassword",
  "displayName": "John Doe"
}

Login

POST /api/auth/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "securepassword"
}

Returns accessToken and refreshToken.

Wallet Authentication

Users can also authenticate with Xaman (XRPL) or MetaMask (EVM):

Method	Endpoint	Description
POST	`/api/xaman/signin`	Initiate Xaman QR sign-in
GET	`/api/xaman/status/:uuid`	Poll sign-in status
POST	`/api/wallets/evm`	MetaMask wallet connect

Wallet

Manage YOOP balances and transactions.

Method	Endpoint	Description
GET	`/api/wallet/balance`	Get YOOP + XRP balance
GET	`/api/wallet/address`	Get XRPL address
GET	`/api/wallet/transactions`	Transaction history
POST	`/api/wallet/send`	Send YOOP (creates Xaman request)

Transactions

GET /api/transactions
Authorization: Bearer <token>

Returns user's transaction history:

{
  "transactions": [
    {
      "id": "abc123",
      "amount": 75,
      "currency": "YOOP",
      "memo": "Snow removal task",
      "created_at": "2026-02-02T10:00:00Z"
    }
  ]
}

Users

Method	Endpoint	Description
GET	`/api/users/me`	Get current user profile
PUT	`/api/users/me`	Update profile
GET	`/api/referral/stats`	Referral statistics

Sisu Fund

Community relief endowment for the Upper Peninsula.

Method	Endpoint	Description
GET	`/api/sisu/fund`	Get fund status
POST	`/api/sisu/contribute`	Contribute to fund
POST	`/api/sisu/apply`	Apply for grant
GET	`/api/sisu/leaderboard`	Top contributors

💚 Fund Split

65% → Sisu Community Fund (grants)

22.5% → Treasury (operations)

12.5% → Reserve (permanent)

Task Marketplace

Method	Endpoint	Description
GET	`/api/tasks/available`	List open tasks
POST	`/api/tasks`	Create task
POST	`/api/tasks/:id/claim`	Claim task
POST	`/api/tasks/:id/complete`	Mark complete

Barter Network

Method	Endpoint	Description
GET	`/api/barter/offers/public`	Public offers (no auth)
GET	`/api/barter/offers`	User's offers
POST	`/api/barter/offers`	Create offer

Registered Agents (Hubs)

Method	Endpoint	Description
GET	`/api/hubs/nearby`	Find hubs by location
POST	`/api/hubs/apply`	Apply to become hub

NorthernWISP Integration

NorthernWISP is a social network built on the 906.sh ecosystem. It uses our API for:

User authentication (shared accounts)
YOOP tipping and payments
Community reputation scores
Referral tracking

Visit NorthernWISP →

DeltaCounty.Services Integration

DeltaCounty.Services is a marketplace built on the 906.sh ecosystem. It uses our API for:

YOOP payments for services
Task and gig economy
Barter matching
Registered agent/hub network

Visit DeltaCounty.Services →

XRPL Configuration

Token Details

Currency Code	`YOOP`
Currency Hex	`594F4F5000000000000000000000000000000000`
Issuer	`rH1HwiQWmBKNTUz6yupP8HeEZ2tNMEUn6v`
Network	Testnet (mainnet-ready)
WebSocket	`wss://s.altnet.rippletest.net:51233`

Rate Limits

Endpoint Type	Limit
General	100 requests/15 min
Auth	10 requests/15 min
Wallet	30 requests/15 min

Error Responses

{
  "error": "Error message here"
}

Code	Meaning
400	Bad request
401	Unauthorized
403	Forbidden
404	Not found
429	Rate limited
500	Server error

Need help? Join our Discord or email dev@906.sh