Connect to Bitcoin via Vezgo API

Accounts

Positions

Transactions

Support for Accounts, Positions and Transactions enabled.

Retrieves a maximum of 5000 new transactions per sync however for larger wallets having transactions more than 10,000 it retrieves 1000 transactions per sync, and up to 50,000 transactions in total.

The connector works with either a bitcoin address or an xPub/yPub/zPub key.

In case of a bitcoin address, it tracks balances and transactions for that address only.
In case of an extended public key, it tracks balances and transactions for each of the addresses generated from that key.

Full List of Integrations

Data mapping

A field-level guide to the Vezgo API data for Bitcoin — what each attribute means and where to read it — so you can map it into your own system.

Data	Where to read it	Source on Bitcoin
Account & wallet	`account.wallets[].address`	The connected Bitcoin address or extended public key (xpub). An xpub derives all of the wallet's addresses; one address/xpub is one account. wallet.address holds it and is the stable identity reused across syncs and reconnects.
Balances / positions	`account.balances[]`	A single native BTC balance — Bitcoin is UTXO-based, so there are no tokens or NFTs. The balance has ticker BTC, amount, decimals and fiat_value (USD).
Transactions	`GET /accounts/:id/transactions`	Native BTC deposits and withdrawals (UTXO), one per on-chain transaction. See "How to read a transaction" below.
Assets / securities	`balance.ticker`	Only the native coin BTC — there are no token contracts on Bitcoin, so ticker_address is not used.

How to read a transaction

Each Bitcoin transaction is a single native BTC movement (UTXO). Read it from the transaction itself:

Native BTC movement — parts[] (direction received/sent, ticker "BTC", amount, fiat_value) and the network fee in fees[] (always BTC).
Counterparties — parts[0] has from_address / to_address plus other_parties[] (UTXO transactions carry multiple inputs and outputs).
The on-chain transaction hash is in misc.origin_id; misc.owner_address is the wallet address (for an xpub wallet, the specific derived address involved — wallet.address holds the xpub).

// One Vezgo transaction = one on-chain transaction (tx.misc.origin_id = hash)
const hash = tx.misc.origin_id;        // on-chain transaction hash
const dir  = tx.transaction_type;      // "deposit" | "withdrawal" (canonical direction)
const kind = tx.misc.origin_type;      // "IN" (deposit) or "OUT" (withdrawal)

const native  = tx.parts?.[0];               // native BTC movement (ticker "BTC")
const gas     = tx.fees?.[0];                // network fee, always in BTC
const parties = native?.other_parties ?? []; // extra UTXO inputs / outputs

// Bitcoin is native-only: no tokenTransfers / nftTransfers / internalTransfers.

Where to read it	Attributes	What it is
`tx.transaction_type`	`"deposit" \| "withdrawal"`	Canonical direction of the transaction.
`tx.parts[0]`	`direction, ticker ("BTC"), amount, fiat_value, from_address, to_address, other_parties`	Native BTC movement. other_parties holds the extra UTXO inputs/outputs.
`tx.fees[0]`	`ticker ("BTC"), amount, fiat_value`	Network fee — always paid in BTC.

misc.origin_type is one of:

Supported

Native BTC balance and transfers
Address and extended-public-key (xpub) wallets
Network fees (reported in BTC)
USD fiat valuation for balances and transactions

Notes & limitations

Bitcoin is UTXO / native-only — no tokens, NFTs or staking.
decimals may be null for some chains (e.g. Dash, Litecoin); amount is in whole-coin units regardless.
fees[] is present on deposits too — there it is the whole on-chain network fee (economically paid by the sender), not a charge to your wallet; the connected wallet only bears the fee on sends/withdrawals.
Up to ~5,000 transactions per sync for typical wallets; for very large wallets the per-sync batch is smaller (~1,000) and history is imported incrementally over later syncs. Wallets with extremely large histories (50k+ transactions) are not supported.

See the full Vezgo object reference

Try to connect to Bitcoin in our Demo Sandbox

Open Demo

Let's get you started

To get your API Keys, sign up on the portal or reach out to the team at sales@vezgo.com

Talk to Sales Explore a Demo