Skip to main content
POST
/
api
/
v1
/
smart-accounts
/
{smart_account_address}
/
spending-limits
Create a new spending limit
curl --request POST \
  --url https://developer-api.squads.so/api/v1/smart-accounts/{smart_account_address}/spending-limits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-squads-network: <x-squads-network>' \
  --data '
{
  "amount": "<string>",
  "token_address": "<string>",
  "period": "ONE_TIME",
  "transaction_signers": [
    "<string>"
  ],
  "spending_limit_signers": [
    "<string>"
  ],
  "destinations": [
    "<string>"
  ],
  "expiration": 123,
  "fee_config": {
    "currency": "<string>",
    "payer_address": "<string>",
    "self_managed_fees": false
  }
}
'
{
  "spending_limit_address": "<string>",
  "transaction": "<string>",
  "fee": {
    "amount": "<string>",
    "amount_decimal": "<string>",
    "currency": "<string>",
    "sol_equivalent": {
      "amount": "<string>",
      "amount_decimal": "<string>"
    }
  }
}
Create a new spending limit that allows controlled token spending from your Smart Account.

​
Key Concepts

  • Limit Configuration: Set maximum amount and reset period
  • Token Specification: Define which token the limit applies to
  • Transaction Signing: Requires approval from authorized signers

​
Important Notes

  • Amount must be greater than zero
  • Period can be DAY or WEEK
  • Transaction must be signed by enough signers to meet threshold
  • The same token can have multiple spending limits with different periods
  • For native SOL, set token_address to 11111111111111111111111111111111

Authorizations

​
Authorization
string
header
required

UUID-based API key provided by Squads

Headers

​
x-squads-network
enum<string>
required

Specifies the network for the API request

Available options:
mainnet,
devnet

Path Parameters

​
smart_account_address
string
required

The address of the smart account

Body

application/json
​
amount
string<uint64>
required
​
token_address
string
required
​
period
enum<string>
required

Reset period for spending limits

Available options:
ONE_TIME,
DAILY,
WEEKLY,
MONTHLY,
YEARLY
​
transaction_signers
string[]
​
spending_limit_signers
string[]
​
destinations
string[]
​
expiration
integer<int64>
​
fee_config
object

Response

Spending limit created successfully

​
spending_limit_address
string
​
transaction
string
​
fee
object