Knit API Documentation

Create an API Account

{{baseUrl}}/api/v1/business-api-services-wallets

Headers

• Authentication: Authorization: Bearer <token> (recommended) or the legacy X-API-KEY: {{apiKey}}.
• Accept: application/json

Prerequisites

• Your business must be KYB-approved and have access to the Developer → API section inside the Knit dashboard.
• An API account is created per token (e.g. one for USDT, another for USDC). Duplicate creations return 409 Payout wallet already exists.
• Fund the business wallet first; transferring from business wallet → API account is how you load balance for payouts.

Behavior Notes

• Newly created accounts start at amount = 0 and will only change when collections/wallets credit funds or payouts debit funds.
• The controller automatically binds the account to the authenticated business, so the token field is the only required input.
• API accounts correspond to the BusinessApiServicesWallet model in the core repo; each payout references one via business_api_services_wallet_id.

Request Body

{
  "token": "USDT"
}

Sample Request

curl --location -g '{{baseUrl}}/api/v1/business-api-services-wallets' \
--header 'X-API-KEY: {{apiKey}}' \
--header 'Accept: application/json' \
--data '{
    "token": "USDT"
}'

Sample Response

{
  "success": true,
  "status": 201,
  "data": {
    "token": "USDT",
    "userId": "a266545-2c6c-43c9-a288-6167e2b2b591",
    "amount": 0,
    "id": "c7ddb254-5da1-4136-b19e-733a00ar5646",
    "updatedAt": "2024-02-22T14:16:23.000000Z",
    "createdAt": "2024-02-22T14:16:23.000000Z"
  },
  "message": "Payout wallets fetched successfully"
}