Utila's REST API gives developers secure, programmatic access to the full platform: wallet and balance monitoring, real-time webhooks, transaction initiation, wallet creation, and automated co-signing.

Where to start

🔑

Authentication

Generate a service account and sign JWT tokens to authenticate API requests.

Get started →

🔔

Webhooks

Subscribe to transaction and wallet events. Verify signatures server-side.

Get started →

🤖

Co-Signer

Automate transaction signing with the CLI co-signer and a webhook policy.

Get started →

📤

Initiate transactions

Construct and submit on-chain transfers to any supported network.

Get started →

Get a token in 60 seconds

import jwt
import datetime
import os

SERVICE_ACCOUNT_EMAIL = os.environ["SA_EMAIL"]

with open("private_key.pem", "r") as f:
    SERVICE_ACCOUNT_PRIVATE_KEY = f.read().strip()

token = jwt.encode(
    {
        "sub": SERVICE_ACCOUNT_EMAIL,
        "aud": "https://api.utila.io/",
        "exp": datetime.datetime.now(datetime.timezone.utc)
               + datetime.timedelta(hours=1),
    },
    SERVICE_ACCOUNT_PRIVATE_KEY.replace("\\n", "\n"),
    algorithm="RS256",
)

# Use as: Authorization: Bearer TOKEN

import * as fs from 'fs';
import * as jwt from 'jsonwebtoken';
import * as path from 'path';

const SERVICE_ACCOUNT_EMAIL = process.env.SA_EMAIL!;
const privateKeyPath = path.join(__dirname, 'private_key.pem');
const SERVICE_ACCOUNT_PRIVATE_KEY = fs.readFileSync(privateKeyPath, 'utf8').trim();

const token = jwt.sign(
  {
    sub: SERVICE_ACCOUNT_EMAIL,
    aud: "https://api.utila.io/",
    exp: Math.floor(Date.now() / 1000) + 60 * 60,
  },
  SERVICE_ACCOUNT_PRIVATE_KEY.replace(/\\n/g, '\n'),
  { algorithm: "RS256" }
);

// Use as: Authorization: Bearer TOKEN

# Download the CLI from the resource center, then:
utila-cli login --account YOUR_SA_EMAIL --key ./private_key.pem

# The CLI manages token generation automatically for all subsequent commands.

Terminology

Vault

An organization's workspace with a shared security policy and key material. A vault contains multiple wallets.

Wallet

A set of blockchain addresses grouped for a financial entity or purpose. Each chain has one address per wallet (except Bitcoin).

Asset

A cryptocurrency or token supported by Utila.

Transaction

A logged asset transfer or key signing action. Transitions through states from creation to CONFIRMED or a terminal error state.

Service account

A virtual API user granted either a viewer or signer role within a vault.

Co-Signer

A tool integrated in the Utila CLI that signs transactions automatically using a secure key share in your environment.