Privy offers low-level APIs you can use to interact with wallets and user objects directly. This means APIs to interface with the following resources:

  • Users: create user objects with appropriate linked accounts and pregenerate wallets for them.
  • Wallets: create, update and use wallets across blockchains.
  • Authorization keys: create and manage authorization keys to manage wallets.
  • Policies: create and manage policies tied to wallets.

Read more about direct API access below.

​
Base URL

All requests to the Privy API must be made to the following base URL:

https://api.privy.io

HTTPS is required for all requests. HTTP requests will be rejected.

​
Authentication

All API endpoints require authentication using Basic Auth and a Privy App ID header. Include the following headers with every request:

​
Authorization
string
required

Basic Auth header with your app ID as the username and your app secret as the password.

​
privy-app-id
string
required

Your Privy app ID as a string.

Requests missing either of these headers will be rejected by Privy’s middleware.

Your Privy app ID and app secret can be found in the App settings > Basics tab for your app.

​
Examples

fetch('https://api.privy.io/v1/wallets', {
  method: 'GET',
  headers: {
    'Authorization': `Basic ${btoa('insert-your-app-id' + ':' + 'insert-your-app-secret')}`,
    'privy-app-id': 'insert-your-app-id',
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data));