DocsAPI ReferenceLogin
Wallet

Create the wallet

Creates the wallet for the authenticated PID with a user-supplied Solana address. The chain is fixed to `solana` for V3 (single-chain MVP). A PID has at most one wallet: creating again returns the existing wallet. Custody is record-only — Peridot does not generate, hold, or return any key material.

Deprecated

POST
/wallet

Creates the wallet for the authenticated PID with a user-supplied Solana address. The chain is fixed to solana for V3 (single-chain MVP).

A PID has at most one wallet: creating again returns the existing wallet. Custody is record-only — Peridot does not generate, hold, or return any key material.

Authorization

cookieAuth
pid_access<token>

JWT access token set by /auth/google/callback or /auth/refresh

In: cookie

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/wallet" \  -H "Content-Type: application/json" \  -d '{    "address": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "chain": "solana",  "address": "string",  "status": "active",  "createdAt": "2019-08-24T14:15:22Z"}

Record a submitted on-chain transaction POST

Records the on-chain submission against a pending, unexpired intent and marks it executed (single-use replay protection). Submission itself happens through the SDK/adapter.

Quote the realtime network fee for a sponsored withdrawal POST

Returns the backend's realtime network-cost estimate plus the fixed protocol percentage for the active fee policy. The client signs the intent + policy (never amounts) and echoes the quoted network fee as the drift reference.