Quickstart

Create a vault and send your first transaction in 5 minutes.

1. Create API Credentials

Sign in to wallet.cubewire.com
Go to Settings → API Access
Click Generate Credential
Enter a name, select roles, and set expiration
Copy the Client ID and Client Secret (the secret is only shown once)

export CUBEWIRE_CLIENT_ID="your-client-id"
export CUBEWIRE_CLIENT_SECRET="your-client-secret"

Save your credentials

The Client Secret is only displayed once when generated. Store it securely—you'll need both the Client ID and Secret to authenticate.

Prefer a visual interface?

Open our Postman Collection to explore the API interactively.

2. Get an Access Token

Exchange your credentials for an access token:

curl -X POST https://api.cubewire.com/api/v1/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$CUBEWIRE_CLIENT_ID" \
  -d "client_secret=$CUBEWIRE_CLIENT_SECRET"

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Save the token for subsequent requests:

export ACCESS_TOKEN="eyJhbGciOiJSUzI1NiIs..."

Token Expiration

Access tokens expire after 1 hour. Request a new token when you receive a 401 Unauthorized response.

3. Create a Vault

curl -X POST https://api.cubewire.com/api/v1/vaults \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My First Vault", "type": "TESTNET"}'

{
  "id": "vault_a1b2c3d4",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bE2a",
  "name": "My First Vault",
  "type": "TESTNET"
}

Save the id and address for the next steps.

4. Fund Your Vault

Get free test tokens from the Cubewire Testnet faucet:

Copy your vault address
Visit the Cubewire Faucet
Paste your address and request tokens

Recommended for Development

Use Cubewire Testnet for development. It's fast, free, and purpose-built for testing your integration.

5. Send a Transaction

curl -X POST https://api.cubewire.com/api/v1/transaction/send \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 62831,
    "sender": { "vaultId": "vault_a1b2c3d4" },
    "recipient": { "address": "0x1234567890123456789012345678901234567890" },
    "asset": { "type": "native" },
    "amount": "0.001"
  }'

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING_WORKFLOW_START",
  "message": "Transaction submitted successfully"
}

View your transaction status using the Get Transaction Status endpoint with the transactionId.

That's It!

You just created a vault and sent a transaction. Cubewire handled key management, gas estimation, signing, and broadcasting.

Architecture — Understand how Cubewire works under the hood
Core Concepts — Key domain concepts for building on Cubewire

Quickstart

Create a vault and send your first transaction in 5 minutes.

1. Create API Credentials

Sign in to wallet.cubewire.com
Go to Settings → API Access
Click Generate Credential
Enter a name, select roles, and set expiration
Copy the Client ID and Client Secret (the secret is only shown once)

export CUBEWIRE_CLIENT_ID="your-client-id"
export CUBEWIRE_CLIENT_SECRET="your-client-secret"

Save your credentials

The Client Secret is only displayed once when generated. Store it securely—you'll need both the Client ID and Secret to authenticate.

Prefer a visual interface?

Open our Postman Collection to explore the API interactively.

2. Get an Access Token

Exchange your credentials for an access token:

curl -X POST https://api.cubewire.com/api/v1/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$CUBEWIRE_CLIENT_ID" \
  -d "client_secret=$CUBEWIRE_CLIENT_SECRET"

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Save the token for subsequent requests:

export ACCESS_TOKEN="eyJhbGciOiJSUzI1NiIs..."

Token Expiration

Access tokens expire after 1 hour. Request a new token when you receive a 401 Unauthorized response.

3. Create a Vault

curl -X POST https://api.cubewire.com/api/v1/vaults \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My First Vault", "type": "TESTNET"}'

{
  "id": "vault_a1b2c3d4",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bE2a",
  "name": "My First Vault",
  "type": "TESTNET"
}

Save the id and address for the next steps.

4. Fund Your Vault

Get free test tokens from the Cubewire Testnet faucet:

Copy your vault address
Visit the Cubewire Faucet
Paste your address and request tokens

Recommended for Development

Use Cubewire Testnet for development. It's fast, free, and purpose-built for testing your integration.

5. Send a Transaction

curl -X POST https://api.cubewire.com/api/v1/transaction/send \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 62831,
    "sender": { "vaultId": "vault_a1b2c3d4" },
    "recipient": { "address": "0x1234567890123456789012345678901234567890" },
    "asset": { "type": "native" },
    "amount": "0.001"
  }'

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING_WORKFLOW_START",
  "message": "Transaction submitted successfully"
}

View your transaction status using the Get Transaction Status endpoint with the transactionId.

That's It!

You just created a vault and sent a transaction. Cubewire handled key management, gas estimation, signing, and broadcasting.

Architecture — Understand how Cubewire works under the hood
Core Concepts — Key domain concepts for building on Cubewire

Quickstart

Create a vault and send your first transaction in 5 minutes.

1. Create API Credentials

Sign in to wallet.cubewire.com
Go to Settings → API Access
Click Generate Credential
Enter a name, select roles, and set expiration
Copy the Client ID and Client Secret (the secret is only shown once)

export CUBEWIRE_CLIENT_ID="your-client-id"
export CUBEWIRE_CLIENT_SECRET="your-client-secret"

Save your credentials

The Client Secret is only displayed once when generated. Store it securely—you'll need both the Client ID and Secret to authenticate.

Prefer a visual interface?

Open our Postman Collection to explore the API interactively.

2. Get an Access Token

Exchange your credentials for an access token:

curl -X POST https://api.cubewire.com/api/v1/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$CUBEWIRE_CLIENT_ID" \
  -d "client_secret=$CUBEWIRE_CLIENT_SECRET"

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Save the token for subsequent requests:

export ACCESS_TOKEN="eyJhbGciOiJSUzI1NiIs..."

Token Expiration

Access tokens expire after 1 hour. Request a new token when you receive a 401 Unauthorized response.

3. Create a Vault

curl -X POST https://api.cubewire.com/api/v1/vaults \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My First Vault", "type": "TESTNET"}'

{
  "id": "vault_a1b2c3d4",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bE2a",
  "name": "My First Vault",
  "type": "TESTNET"
}

Save the id and address for the next steps.

4. Fund Your Vault

Get free test tokens from the Cubewire Testnet faucet:

Copy your vault address
Visit the Cubewire Faucet
Paste your address and request tokens

Recommended for Development

Use Cubewire Testnet for development. It's fast, free, and purpose-built for testing your integration.

5. Send a Transaction

curl -X POST https://api.cubewire.com/api/v1/transaction/send \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 62831,
    "sender": { "vaultId": "vault_a1b2c3d4" },
    "recipient": { "address": "0x1234567890123456789012345678901234567890" },
    "asset": { "type": "native" },
    "amount": "0.001"
  }'

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING_WORKFLOW_START",
  "message": "Transaction submitted successfully"
}

View your transaction status using the Get Transaction Status endpoint with the transactionId.

That's It!

You just created a vault and sent a transaction. Cubewire handled key management, gas estimation, signing, and broadcasting.

Architecture — Understand how Cubewire works under the hood
Core Concepts — Key domain concepts for building on Cubewire

Quickstart

Create a vault and send your first transaction in 5 minutes.

1. Create API Credentials

Sign in to wallet.cubewire.com
Go to Settings → API Access
Click Generate Credential
Enter a name, select roles, and set expiration
Copy the Client ID and Client Secret (the secret is only shown once)

export CUBEWIRE_CLIENT_ID="your-client-id"
export CUBEWIRE_CLIENT_SECRET="your-client-secret"

Save your credentials

The Client Secret is only displayed once when generated. Store it securely—you'll need both the Client ID and Secret to authenticate.

Prefer a visual interface?

Open our Postman Collection to explore the API interactively.

2. Get an Access Token

Exchange your credentials for an access token:

curl -X POST https://api.cubewire.com/api/v1/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$CUBEWIRE_CLIENT_ID" \
  -d "client_secret=$CUBEWIRE_CLIENT_SECRET"

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Save the token for subsequent requests:

export ACCESS_TOKEN="eyJhbGciOiJSUzI1NiIs..."

Token Expiration

Access tokens expire after 1 hour. Request a new token when you receive a 401 Unauthorized response.

3. Create a Vault

curl -X POST https://api.cubewire.com/api/v1/vaults \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My First Vault", "type": "TESTNET"}'

{
  "id": "vault_a1b2c3d4",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bE2a",
  "name": "My First Vault",
  "type": "TESTNET"
}

Save the id and address for the next steps.

4. Fund Your Vault

Get free test tokens from the Cubewire Testnet faucet:

Copy your vault address
Visit the Cubewire Faucet
Paste your address and request tokens

Recommended for Development

Use Cubewire Testnet for development. It's fast, free, and purpose-built for testing your integration.

5. Send a Transaction

curl -X POST https://api.cubewire.com/api/v1/transaction/send \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 62831,
    "sender": { "vaultId": "vault_a1b2c3d4" },
    "recipient": { "address": "0x1234567890123456789012345678901234567890" },
    "asset": { "type": "native" },
    "amount": "0.001"
  }'

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING_WORKFLOW_START",
  "message": "Transaction submitted successfully"
}

View your transaction status using the Get Transaction Status endpoint with the transactionId.

That's It!

You just created a vault and sent a transaction. Cubewire handled key management, gas estimation, signing, and broadcasting.

Architecture — Understand how Cubewire works under the hood
Core Concepts — Key domain concepts for building on Cubewire

Quickstart

1. Create API Credentials

Save your credentials

Prefer a visual interface?

2. Get an Access Token

Token Expiration

3. Create a Vault

4. Fund Your Vault

Recommended for Development

5. Send a Transaction

That's It!

Next

Quickstart

1. Create API Credentials

Save your credentials

Prefer a visual interface?

2. Get an Access Token

Token Expiration

3. Create a Vault

4. Fund Your Vault

Recommended for Development

5. Send a Transaction

That's It!

Next

Quickstart

1. Create API Credentials

Save your credentials

Prefer a visual interface?

2. Get an Access Token

Token Expiration

3. Create a Vault

4. Fund Your Vault

Recommended for Development

5. Send a Transaction

That's It!

Next

Quickstart

1. Create API Credentials

Save your credentials

Prefer a visual interface?

2. Get an Access Token

Token Expiration

3. Create a Vault

4. Fund Your Vault

Recommended for Development

5. Send a Transaction

That's It!

Next