Create Managed Signing Wallet
POST
https://api-prod.useknit.io/api/v1/managed-signing/wallets
This endpoint creates a new managed signing wallet for a specified blockchain network type.
Supported Networks
| Network | Identifier |
|---|---|
| Ethereum | ETHEREUM_MAINNET (alias ETH_MAINNET) |
| Polygon | MATIC_MAINNET |
| BNB Smart Chain | BSC_MAINNET |
| Base | BASE_MAINNET |
| Polygon Amoy — sandbox only | MATIC_AMOY |
Body
typestringrequired
The wallet type. Currently EVM is the only accepted value.
networksstring[]required
The networks the wallet should be usable on. Must contain at least one entry, and every entry must be a supported network.
merchantCallbackUrlstringrequired
Where callbacks for this wallet are delivered. Must be a publicly
reachable http:// or https:// URL — private, loopback, and internal
addresses are rejected.
⚠️
merchantCallbackUrl is required. A wallet cannot be created without a
reachable callback URL.
Request body
{
"type": "EVM",
"networks": ["ETHEREUM_MAINNET"],
"merchantCallbackUrl": "https://example.com/callback"
}Request
curl "https://api-prod.useknit.io/api/v1/managed-signing/wallets" \
-H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"type": "EVM",
"networks": ["ETHEREUM_MAINNET"],
"merchantCallbackUrl": "https://example.com/callback"
}'Response
Response
{
"statusCode": 201,
"message": "Wallet created",
"data": {
"id": "<local-wallet-id>",
"businessId": "<business-id>",
"type": "EVM",
"networks": ["ETHEREUM_MAINNET"],
"network": "ETHEREUM_MAINNET",
"address": "0x...",
"hdPath": "m/44'/60'/0'/0/0",
"keyId": "<key-id>",
"isActive": true,
"merchantCallbackUrl": "https://example.com/callback",
"createdAt": "2026-01-20T18:30:40.912Z",
"updatedAt": "2026-01-20T18:30:40.912Z"
},
"success": true
}Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Local wallet ID (use this in subsequent requests) |
businessId | string | Your business ID |
type | string | Wallet type |
networks | array | Supported networks |
network | string | Primary network |
address | string | Wallet address |
hdPath | string | HD derivation path |
keyId | string | Key identifier |
isActive | boolean | Wallet active status |
merchantCallbackUrl | string | Callback URL |
createdAt | string | Creation timestamp |
updatedAt | string | Last update timestamp |
