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.
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..."
Token Expiration
Access tokens expire after 1 hour. Request a new token when you receive a 401 Unauthorized response.
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:
- 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.
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
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.
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..."
Token Expiration
Access tokens expire after 1 hour. Request a new token when you receive a 401 Unauthorized response.
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:
- 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.
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