Core concepts

Data sharing & earnings

Opt files into the AI-training marketplace, set a per-file price, and accrue earnings as agents use your data. Balances are tracked end-to-end; on-chain payout is in preview.

How it works

udrive includes an opt-in marketplace where AI agents can train on data that owners have explicitly shared. When a file you opted in is used, a training event is recorded and an earning accrues to your account based on your price and the tokens consumed. Nothing is shared unless you turn it on.

  • Owner-controlled. Files are private to the marketplace until you set allowTraining.
  • Priced by you. Each file carries a trainingPrice; you can also set an account default.
  • Transparent. Every use shows up as a line item with the model name, token count, and amount.

Opting a file in

Toggle training on a file and set its price from the drive, or via the API. You can flip it off again at any time.

Shell
curl -X PATCH https://udrive.one/api/files/$FILE_ID \
  -H 'content-type: application/json' \
  -b "$SESSION_COOKIE" \
  -d '{ "allowTraining": true, "trainingPrice": 0.05 }'

Account-level defaults live in your settings under dataSharing and trainingPrice, applied to new uploads — see the API reference.

Earnings & balances

The earnings endpoint returns a rolling summary plus history. Each earning has a status as it matures.

  • accrued — recorded from a training event, not yet matured.
  • claimable — eligible to withdraw.
  • paid — settled out.
GET /api/earningsJSON
{
  "totalAccrued": "12.480000",
  "claimable": "8.250000",
  "paid": "4.230000",
  "history": [
    {
      "id": "e1…",
      "fileId": "0f3c…",
      "amount": "0.050000",
      "kind": "training_use",
      "status": "claimable",
      "createdAt": "2026-06-25T18:04:11.000Z"
    }
  ]
}

The dashboard also shows a live “models training now” feed built from recent training events, so the marketplace feels alive even before payouts settle.

Claiming

When you have a claimable balance, the dashboard surfaces a Claim action backed by POST /api/earnings/claim.

Payouts are in preview

Claiming today records the intent and marks balances as claimed in the ledger — it does not yet perform an on-chain transfer. The UI is fully wired so that, once payouts ship, the same flow settles to your wallet with a real transaction signature.