Skip to main content
POST
/
api
/
v0
/
smart_account
/
transaction
/
spending_limit
/
create
Create Spending Limit
curl --request POST \
  --url https://developer-api.squads.so/api/v0/smart_account/transaction/spending_limit/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "smart_account_address": "<string>",
  "amount": "<string>",
  "token_address": "<string>",
  "period": "ONE_TIME",
  "transaction_signers": [
    "<string>"
  ],
  "spending_limit_signers": [
    "<string>"
  ],
  "destinations": [
    "<string>"
  ],
  "fee_config": {
    "currency": "sol",
    "payer_address": "<string>"
  }
}
'
{
  "spending_limit_address": "<string>",
  "transaction": "<string>",
  "fee": {
    "amount": "<string>",
    "amount_decimal": "<string>",
    "currency": "<string>",
    "sol_equivalent": {
      "amount": "<string>",
      "amount_decimal": "<string>"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Headers

​
x-squads-network
enum<string>
default:mainnet

Specifies which Solana network to use. Defaults to 'mainnet' if not provided. Valid values are 'devnet' or 'mainnet'.

Available options:
devnet,
mainnet

Body

application/json
​
smart_account_address
string
required

The address of the Smart Account

​
amount
string<uint64>
required

The maximum amount in base units that can be spent within the specified period

​
token_address
string
required

The address of the token mint for which this spending limit applies

​
period
enum<string>
required

Defines the period for spending limits:

  • ONE_TIME: Limit can only be used once
  • DAY: Limit resets daily
  • WEEK: Limit resets weekly
  • MONTH: Limit resets monthly
Available options:
ONE_TIME,
DAY,
WEEK,
MONTH
​
transaction_signers
string[]
required

List of addresses that will sign this transaction

​
spending_limit_signers
string[]
required

List of signer addresses that are authorized to use this spending limit

​
destinations
string[]
required

List of allowed recipient addresses. If empty, funds can be sent to any address

​
fee_config
object
required

Response

Spending limit successfully created

​
spending_limit_address
string
required

The address of the newly created spending limit

​
transaction
string
required

The transaction encoded in base64

​
fee
object
required