API reference - Knot Wallet

The Knot API provides a REST interface for AI agents to manage wallets, execute transactions, and interact with DeFi protocols on Solana.

Base URL

https://api.useknot.xyz

All endpoints are relative to this base URL.

Authentication

Most endpoints require a JWT token in the Authorization header:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Obtain a token through the authentication flow. Tokens expire after 7 days by default. You can configure expiration per-agent via the policy settings.

Request format

Send all request bodies as JSON. Include the following header:

Content-Type: application/json

Response format

All responses follow a consistent envelope structure:

{
  "status": true,
  "statusCode": 200,
  "message": "Operation successful.",
  "data": { ... }
}

Field	Type	Description
`status`	boolean	`true` on success, `false` on error
`statusCode`	number	HTTP status code
`message`	string	Human-readable description
`data`	object	Response payload

Rate limits

Layer	Limit	Window
Global	1,000 requests	per minute
Per-IP	100 requests	per minute
Per-Agent	60 requests	per minute

Exceeding a limit returns 429 Too Many Requests.

Idempotency

For financial operations, include an Idempotency-Key header to prevent duplicate transactions:

Idempotency-Key: unique-request-identifier

If you repeat a request with the same key, the API returns the original response instead of executing the operation again.

Endpoint groups

Authentication

OTP authentication and token management

Wallet

Balances, transfers, trades, and history

Policy

View and update agent spending policies

Utility

Health checks, token lookup, and agent capabilities

For liquidity provision and prediction market endpoints, see the feature documentation: Liquidity provision and Prediction markets.

​Base URL

​Authentication

​Request format

​Response format

​Rate limits

​Idempotency

​Endpoint groups

Authentication

Wallet

Policy

Utility

Base URL

Authentication

Request format

Response format

Rate limits

Idempotency

Endpoint groups