Knit API Documentation
Create Managed Signing Wallet
{{baseUrl}}/api/v1/managed-signing/walletsThis endpoint creates a new managed signing wallet for a specified blockchain network type.
Supported Networks
Production
ETHEREUM_MAINNETMATIC_MAINNETBSC_MAINNETBASE_MAINNET
Testnet (Sandbox/Dev only)
MATIC_AMOY- Polygon Amoy testnet (commonly used for CPN testing)
Headers
X-API-KEY: Your API key for authentication.Accept: Set toapplication/jsonto receive responses in JSON format.Content-Type: Set toapplication/json.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Wallet type (e.g., EVM) |
networks | array | Yes | Array of supported networks |
merchantCallbackUrl | string | No | URL for receiving callbacks |
{
"type": "EVM",
"networks": ["ETHEREUM_MAINNET"],
"merchantCallbackUrl": "https://example.com/callback"
}Sample Request
curl --location -g '{{baseUrl}}/api/v1/managed-signing/wallets' \
--header 'X-API-KEY: {{apiKey}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"type": "EVM",
"networks": ["ETHEREUM_MAINNET"],
"merchantCallbackUrl": "https://example.com/callback"
}'Sample Response
Sample 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 |
