Spend Grants

Authorize another wallet to spend from your balance with controlled limits.

What Are Spend Grants?

A spend grant allows you to authorize another wallet address to spend funds from your account, up to a specified limit and expiry date. This enables delegated spending without sharing your credentials.

Use Cases

Use Case	Description
Team accounts	Let team members deploy without sharing a single wallet
Automated services	Allow a CI/CD pipeline or bot to create deployments on your behalf
Managed deployments	Authorize a managed service provider to maintain your infrastructure

Creating a Grant

Open Billing Settings

Navigate to Settings → Billing → Spend Grants in the dashboard.

Add a New Grant

Click Create Grant and enter the grantee's wallet address.

Set Spending Limit

Specify the maximum amount the grantee can spend from your balance.

Set Expiry Date

Choose when the grant expires. After this date, the grantee can no longer spend.

Confirm

Review the details and confirm. The grantee can begin spending immediately.

Creating a Grant via API

POST /api/v1/grants

curl -X POST \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "grantee": "0x1234...abcd",
    "limit": 500.00,
    "expires_at": "2026-06-01T00:00:00Z"
  }' \
  https://app.kovanetwork.com/api/v1/grants

Response:

{
  "success": true,
  "grant": {
    "id": "grant_8f3a2b1c",
    "grantor": "0xabcd...1234",
    "grantee": "0x1234...abcd",
    "limit": 500.00,
    "spent": 0.00,
    "expires_at": "2026-06-01T00:00:00Z",
    "created_at": "2026-02-11T12:00:00Z"
  }
}

Managing Grants

View Active Grants

GET /api/v1/grants

Returns all grants you have created (as grantor) and grants others have given you (as grantee).

Revoke a Grant

DELETE /api/v1/grants/:id

Only the grantor can revoke a grant. Once revoked, the grantee immediately loses spending access.

curl -X DELETE \
  -H "Authorization: Bearer TOKEN" \
  https://app.kovanetwork.com/api/v1/grants/grant_8f3a2b1c

Grant Revocation

Only the original grantor can revoke a grant. The grantee cannot modify or extend a grant. Make sure you set appropriate spending limits and expiry dates before confirming.

Grant Limits

A grantee's spending is tracked against the grant limit in real time
Once the limit is reached, further spending is blocked until the grantor creates a new grant
Expired grants cannot be renewed -- create a new grant instead
A single grantee can have multiple active grants from different grantors