Pilot environment: testnet, simulated yield, mocked fiat rails — read the disclosure
API referenceChangelog
Vault deposits

List your vault deposits

Your vault deposits, newest first, each with its status on the one savings status vocabulary (QUEUED, PROCESSING, CREDIT_PENDING, COMPLETED, FAILED, REFUNDED, CANCELLED). Filter by status. Fetch one in full with GET /deposits/{id}.

GET
/api/partner/v1/deposits

Your vault deposits, newest first, each with its status on the one savings status vocabulary (QUEUED, PROCESSING, CREDIT_PENDING, COMPLETED, FAILED, REFUNDED, CANCELLED). Filter by status. Fetch one in full with GET /deposits/{id}.

Authorization

bearer
AuthorizationBearer <token>

In: header

Query Parameters

cursor?string

The nextCursor from the previous page. Omit it for the first page. Treat it as opaque.

limit?integer

Rows per page, 1-100. Defaults to 25.

Rangevalue <= 100
Default25
status?string

Only deposits in this status.

Value in

  • "QUEUED"
  • "PROCESSING"
  • "CREDIT_PENDING"
  • "COMPLETED"
  • "FAILED"
  • "REFUNDED"
  • "CANCELLED"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/partner/v1/deposits"
{  "data": {    "items": [      {        "createdAt": "2026-10-06T09:12:44.000Z",        "currency": "USD",        "depositId": "2f6c9a41-3e58-4b70-9d12-6a8f0c3e5b71",        "requestedAmount": "1000",        "settledAt": "2026-10-06T09:12:51.000Z",        "shares": "999.876543210000000000000000",        "status": "COMPLETED",        "subAccountId": "5d3b8e10-2f47-4c9a-b6e8-0a71d4c2f395"      }    ]  },  "success": true,  "timestamp": "2026-09-02T10:15:30.000Z"}

API reference

Every operation in v1, with a link to its generated page carrying the full request and response schema.

Deposit fiat into a curated vault POST

Converts your fiat into vault shares held in your vault sub-account. An idempotency key is MANDATORY: send it as the Idempotency-Key header or as the idempotencyKey body field. Replaying a key returns the original result without re-executing; reusing one with different parameters is rejected with IDEMPOTENCY_KEY_REUSED. Every response carries the pilot disclosure: the environment is a testnet and the yield is simulated, not earned.