Quickstart

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


1. Create API Credentials

  1. Sign in to wallet.cubewire.com
  2. Go to SettingsAPI Access
  3. Click Generate Credential
  4. Enter a name, select roles, and set expiration
  5. 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"

2. Get an Access Token

Exchange your credentials for an access token:

curl -X POST https://api.cubewire.io/oauth/v1/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..."

3. Create a Vault

curl -X POST https://api.cubewire.io/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:

  1. Copy your vault address
  2. Visit the Cubewire Faucet
  3. Paste your address and request tokens

5. Send a Transaction

curl -X POST https://api.cubewire.io/api/v1/vaults/vault_a1b2c3d4/send \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "0x1234567890123456789012345678901234567890",
    "value": "0.001",
    "chainId": 62831
  }'
{
  "transactionId": "tx_x1y2z3",
  "transactionHash": "0xabc123def456...",
  "status": "SUBMITTED"
}

View your transaction on the Cubewire Explorer using the transactionHash.


That's It!

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


Next

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