Developers

The same rails, exposed as a clean REST API.

Everything you can do in the dashboard is available via API. Issue virtual accounts, move money on or off-chain, kick off KYC, subscribe to webhooks. Built on top of Bridge and Hifi — full docs available for both partners.

Quickstart

Send your first dollar in under five minutes.

1

Generate an API key

Settings → API keys → New key. Server-side only. We rotate every 90 days by default.

2

Create a customer

Light-touch metadata at sign-up. Heavy KYC happens via the kyc_link flow when needed.

3

Issue a virtual account

USD ACH/Wire or EUR SEPA. Returns the bank details to share with the payer.

4

Listen to webhooks

Subscribe to transfer.completed and balance.threshold_crossed for real-time updates.

POST https://api.globalone.io/v1/transfers
curl -X POST https://api.globalone.io/v1/transfers \
  -H "Authorization: Bearer go_live_••••" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_01HZK1Q3R5ABCD",
    "source": { "asset": "USD", "amount": 1000 },
    "destination": {
      "asset": "USDC",
      "network": "base",
      "address": "0x9F…2aE7"
    },
    "reference": "April retainer"
  }'

Reference

Endpoint groups and webhook events, in priority order.

Accounts & balances

List balances, issue virtual accounts, and look up customer state.

  • GET /v1/accounts
  • POST /v1/accounts/virtual
  • GET /v1/balances

Transfers

On-ramp, off-ramp, and cross-asset transfers with quoting.

  • POST /v1/transfers/quote
  • POST /v1/transfers
  • GET /v1/transfers/:id

KYC + customers

Create customers, request KYC links, fetch verification status.

  • POST /v1/customers
  • POST /v1/customers/:id/kyc_link
  • GET /v1/customers/:id

Webhooks

Subscribe to transfer status changes, KYC decisions, and balance events.

  • transfer.completed
  • kyc.approved
  • balance.threshold_crossed

SDKs

Typed clients for the languages you actually ship.

TypeScript
npm i @globalone/node
Python
pip install globalone
Go
go get github.com/globalone-io/go
Ruby
gem install globalone