Create Smart Account

cURL

curl --request POST \
  --url https://grid.squads.xyz/api/v0/grid/smart-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Grid-Environment: <x-grid-environment>' \
  --data '
{
  "policies": {
    "authorities": [
      {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "permissions": [
          "CAN_INITIATE"
        ]
      }
    ],
    "threshold": 5,
    "admin_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "time_lock": 1
  },
  "grid_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "memo": "<string>",
  "mpc_provider_info": "<unknown>"
}
'

{
  "created_at": "2021-01-01T00:00:00Z",
  "grid_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "policies": {
    "authorities": [
      {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "permissions": [
          "CAN_INITIATE"
        ]
      }
    ],
    "threshold": 5,
    "admin_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "time_lock": 1
  },
  "smart_account_address": "<string>"
}

POST

smart-accounts

cURL

curl --request POST \
  --url https://grid.squads.xyz/api/v0/grid/smart-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Grid-Environment: <x-grid-environment>' \
  --data '
{
  "policies": {
    "authorities": [
      {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "permissions": [
          "CAN_INITIATE"
        ]
      }
    ],
    "threshold": 5,
    "admin_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "time_lock": 1
  },
  "grid_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "memo": "<string>",
  "mpc_provider_info": "<unknown>"
}
'

{
  "created_at": "2021-01-01T00:00:00Z",
  "grid_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "policies": {
    "authorities": [
      {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "permissions": [
          "CAN_INITIATE"
        ]
      }
    ],
    "threshold": 5,
    "admin_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "time_lock": 1
  },
  "smart_account_address": "<string>"
}

Authorizations

Authorization

string

header

required

API Key for authentication

Headers

X-Grid-Environment

string

required

The environment you’re using. Can be sandbox or production.

Body

application/json

policies

object

required

Smart account policies including authorities and threshold

Show child attributes

policies.authorities

object[]

required

List of authorities that can authorize transactions

Show child attributes

policies.authorities.address

string<pubkey>

required

The public key of the authority

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

policies.authorities.permissions

enum<string>[]

required

List of permissions granted to this authority

Available options:

CAN_INITIATE,

CAN_VOTE,

CAN_EXECUTE

policies.threshold

integer<int32>

required

Number of required signatures for transactions

Required range: 1 <= x <= 10

policies.admin_address

string<pubkey> | null

Optional admin address that can modify the smart account settings

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

policies.time_lock

integer<int32> | null

Optional time lock in seconds for transactions

Required range: x >= 0

grid_user_id

string<uuid> | null

Optional Grid user ID. If not provided, a new user will be created

memo

string | null

Optional memo for the smart account

mpc_provider_info

object

Optional MPC provider information for key management

Show child attributes

mpc_provider_info.Turnkey

object

required

Show child attributes

mpc_provider_info.Turnkey.primary_id

string

required

The primary ID for the MPC provider

mpc_provider_info.Turnkey.wallet_address

string

required

The wallet address for the MPC provider

mpc_provider_info.Turnkey.wallet_id

string

required

The wallet ID for the MPC provider

Response

Smart account created successfully

created_at

string<date-time>

required

UTC timestamp when the smart account was created

Example:

"2021-01-01T00:00:00Z"

grid_user_id

string<uuid>

required

The Grid user ID associated with the smart account

policies

object

required

The policies configured for the smart account

Show child attributes

policies.authorities

object[]

required

List of authorities that can authorize transactions

Show child attributes

policies.authorities.address

string<pubkey>

required

The public key of the authority

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

policies.authorities.permissions

enum<string>[]

required

List of permissions granted to this authority

Available options:

CAN_INITIATE,

CAN_VOTE,

CAN_EXECUTE

policies.threshold

integer<int32>

required

Number of required signatures for transactions

Required range: 1 <= x <= 10

policies.admin_address

string<pubkey> | null

Optional admin address that can modify the smart account settings

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

policies.time_lock

integer<int32> | null

Optional time lock in seconds for transactions

Required range: x >= 0

smart_account_address

string

required

The blockchain address of the created smart account

Get Smart Account

⌘I

Core

Authorizations

Headers

Body

Response