Skip to main content
POST
/
v1
/
company-wallets
Whitelist a company wallet
curl --request POST \
  --url https://api-fundflow.venly.io/v1/company-wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "description": "Main treasury wallet"
}
'
{
  "success": true,
  "result": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "description": "<string>",
    "address": "<string>",
    "verifiedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "version": 123
  }
}
Registers a new company wallet in PENDING status. To verify ownership, send 1 USDC from the wallet to the deposit address returned by Get deposit wallets. Concept guide: Account management
New wallets start as PENDING and must be verified before use. Never share private keys or seed phrases — only the wallet address is required.

Authorizations

​
Authorization
string
header
required

OAuth2 authentication via Venly Identity Platform

Body

application/json

Request to register a new cryptocurrency wallet for the company

​
address
string
required

The blockchain wallet address

Maximum string length: 255
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

​
chain
enum<string>
required

The blockchain network for this wallet

Available options:
ETHEREUM,
POLYGON,
BASE,
ARBITRUM,
SUI
​
description
string

Optional description for the wallet

Maximum string length: 500
Example:

"Main treasury wallet"

Response

Company wallet successfully created

​
success
boolean
default:true
​
result
object

Company cryptocurrency wallet details