Blockdaemon REST API (3.0.0)

Download OpenAPI specification:

Blockdaemon REST API provides a RESTful and uniform way to access blockchain resources, with a rich and reusable model across multiple protocols/cryptocurrencies.

Documentation

Currently supported protocols:

  • algorand
    • mainnet
  • avalanche
    • mainnet-c/testnet-c
  • bitcoin
    • mainnet/testnet/testnet4
  • bitcoincash
    • mainnet/testnet
  • dogecoin
    • mainnet/testnet
  • ethereum
    • mainnet/holesky/sepolia/hoodi
  • litecoin
    • mainnet/testnet
  • near
    • mainnet
  • optimism
    • mainnet
  • polkadot
    • mainnet/westend
  • polygon
    • mainnet/amoy
  • solana
    • mainnet/testnet
  • stellar
    • mainnet/testnet
  • tezos
    • mainnet
  • tron
    • mainnet/nile
  • xrp
    • mainnet

Pagination

Certain resources contain a lot of data, more than what's practical to return for a single request. With the help of pagination, the data is split across multiple responses. Each response returns a subset of the items requested, and a continuation token.

To get the next batch of items, copy the returned continuation token to the continuation query parameter and repeat the request with the new URL. In case no continuation token is returned, there is no more data available.

Protocol and Endpoint Support

Get the Protocols Overview

Returns a full list of all supported protocols and networks.

Authorizations:
apiKeyAuthHeaderbearerAuth

Responses

Response samples

Content type
application/json
{
  • "protocols": [
    ]
}

Get the Protocol Info

Provides information about supported endpoints and generic protocol information.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, near, optimism, polkadot, polygon, solana, stellar, tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

Responses

Response samples

Content type
application/json
{
  • "handle": "bitcoincash",
  • "network": "mainnet",
  • "genesis_number": 0,
  • "endpoints": [
    ]
}

Balances & UTXO

Get a List of Balances for an Address

Returns a list of account balances by a user-defined account address for the supported currencies.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, near, optimism, polkadot, polygon, solana, stellar, tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

address
required
string
Default: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
Examples:
  • 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa - BTC address

The account address of the protocol.

query Parameters
assets
string
Examples:
  • assets=ethereum/native/eth -
  • assets=ethereum/contract/0x0f5d2fb29fb7d3cfee444a200298f468908cc942/erc-20 -
  • assets=ethereum/native/eth,ethereum/contract/0x0f5d2fb29fb7d3cfee444a200298f468908cc942/erc-20 -

Comma-separated list of asset paths to filter. If the list is empty or all elements are empty, this filter has no effect. Filtering by asset is applicable only for:

  • Balances endpoints: algorand, avalanche, bitcoincash, ethereum, litecoin, optimism, polygon, polkadot, solana
  • Transactions endpoints: algorand, avalanche, ethereum

Find all the asset paths on this page.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get a List of Balances for Multiple Addresses

Returns a list of account balances for a user-defined list of account addresses:

  • The filter allows up to 200 addresses for:
    • Algorand
    • Bitcoin
    • Solana
    • Stellar
    • Ethereum
  • The filter allows up to 10 addresses for other supported protocols.
Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, near, optimism, polkadot, polygon, solana, stellar, tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

query Parameters
assets
string
Examples:
  • assets=ethereum/native/eth -
  • assets=ethereum/contract/0x0f5d2fb29fb7d3cfee444a200298f468908cc942/erc-20 -
  • assets=ethereum/native/eth,ethereum/contract/0x0f5d2fb29fb7d3cfee444a200298f468908cc942/erc-20 -

Comma-separated list of asset paths to filter. If the list is empty or all elements are empty, this filter has no effect. Filtering by asset is applicable only for:

  • Balances endpoints: algorand, avalanche, bitcoincash, ethereum, litecoin, optimism, polygon, polkadot, solana
  • Transactions endpoints: algorand, avalanche, ethereum

Find all the asset paths on this page.

Request Body schema: application/json
required
addresses
Array of strings
Default: ["1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa","bc1qex0aqq8mxqfh4cpl62eg755836djjx20yzuuu8"]

A list of addresses.

Responses

Request samples

Content type
application/json
[
  • "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  • "bc1qex0aqq8mxqfh4cpl62eg755836djjx20yzuuu8"
]

Response samples

Content type
application/json
{
  • "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa": [
    ],
  • "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh": [
    ]
}

Get a Financial Report for an Address Between a Time Period

Returns a financial report by a user-defined account address between a time period. Default timescale is within the last 30 days.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "polkadot"
Examples:
  • polkadot -

Protocol handle, one of: algorand, polkadot, stellar tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

address
required
string
Default: "12yi4uHFbnSUryffXT7Xq92fbGC3iXvCs3vz9HjVgpb4sBvL"
Examples:
  • 12yi4uHFbnSUryffXT7Xq92fbGC3iXvCs3vz9HjVgpb4sBvL - Polkadot address

The account address of the protocol.

query Parameters
from
integer
Example: from=961846434

The Unix Timestamp from where to start.

to
integer
Example: to=1119612834

The Unix Timestamp from where to end.

page_token
string
Example: page_token=xyz

The token to retrieve more items in the next request. Use the next_page_token returned from the previous response for this parameter.

page_size
integer
Example: page_size=1000

The max number of items to return in a response. Defaults to 50k and is capped at 100k.

Responses

Response samples

Content type
application/json
{
  • "fields": [
    ],
  • "items": 1,
  • "limit": 50000
}

Blocks

Get the Current Block Number

Returns the current block number/height of the protocol.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, near, optimism, polkadot, polygon, solana, stellar, tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

Responses

Response samples

Content type
application/json
801212

Get the Current Block Hash

Get the current block id (hash) of the protocol.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, near, optimism, polkadot, polygon, solana, stellar, tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

Responses

Response samples

Content type
application/json
"3ea7cfb439e0baa4d91525b66b1f7b4e79ac0302a054a83d12f4e2ee7c933c8f"

Get a Block by Number or Hash

Get a block and all its transactions by a user-defined block number or block hash.

Use -1 or current parameter to return the current block.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, near, optimism, polkadot, polygon, solana, stellar, tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

block_identifier
required
string
Default: "0000000000000000000590fc0f3eba193a278534220b2b37e9849e1a770ca959"
Examples:
  • 0000000000000000000590fc0f3eba193a278534220b2b37e9849e1a770ca959 -
  • 100000 -

The block identifier, hash or number.

Responses

Response samples

Content type
application/json
{
  • "number": 700000,
  • "id": "0000000000000000000590fc0f3eba193a278534220b2b37e9849e1a770ca959",
  • "parent_id": "0000000000000000000aa3ce000eb559f4143be419108134e0ce71042fc636eb",
  • "date": 1631333672,
  • "num_txs": 1276,
  • "txs": [
    ]
}

Get a Block Identifier by Number of Hash

Get the minimal block data, block header, by a user-defined block number or block hash.

Use -1 or current parameter to return the current block.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, near, optimism, polkadot, polygon, solana, stellar, tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

block_identifier
required
string
Default: "0000000000000000000590fc0f3eba193a278534220b2b37e9849e1a770ca959"
Examples:
  • 0000000000000000000590fc0f3eba193a278534220b2b37e9849e1a770ca959 -
  • 100000 -

The block identifier, hash or number.

Responses

Response samples

Content type
application/json
{
  • "number": 700000,
  • "id": "0000000000000000000590fc0f3eba193a278534220b2b37e9849e1a770ca959",
  • "parent_id": "0000000000000000000aa3ce000eb559f4143be419108134e0ce71042fc636eb",
  • "date": 1631333672,
  • "num_txs": 1276
}

Get a List of Block Identifiers

Returns a list of minimal block data, block headers such as block hash and block number.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: avalanche, bitcoin, bitcoincash, dogecoin, ethereum,litecoin, optimism, polkadot, polygon, tezos.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

query Parameters
order
string
Default: "desc"
Enum: "desc" "asc"

The pagination order.

page_token
string
Example: page_token=8185.123

The token to retrieve more items in the next request. Use the next_page_token returned from the previous response for this parameter.

page_size
integer
Example: page_size=25

Max number of items to return in a response. Defaults to 25 and is capped at 100.

Responses

Response samples

Content type
application/json
{
  • "total": 4,
  • "data": [
    ],
  • "meta": {
    }
}

Fee estimator

Get the Fee Estimation

Returns fee estimation in decimals.This endpoint will return 3 fee estimations: fast, medium and slow.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, polkadot, polygon and solana.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

Responses

Response samples

Content type
application/json
Example
{
  • "most_recent_block": 17820703,
  • "estimated_fees": {
    }
}

Transactions

Get the Transaction Confirmations

Returns the number of transaction confirmations by a user-defined transaction hash.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, optimism, polkadot, polygon, stellar, tezos.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

hash
required
string
Default: "71d4f3412ec11128bbd9ce988d5bff2ec3bb6ea3953c8faf189d88ae49de9f7a"
Examples:
  • 71d4f3412ec11128bbd9ce988d5bff2ec3bb6ea3953c8faf189d88ae49de9f7a -
  • 0x6d550b76008d75d25a735d2d96c640cc13b7a711372557955fbd3b1cad8a78cb -

The transaction hash.

Responses

Response samples

Content type
application/json
{
  • "current_height": 801213,
  • "tx_id": "71d4f3412ec11128bbd9ce988d5bff2ec3bb6ea3953c8faf189d88ae49de9f7a",
  • "confirmations": 39001
}

Get a Transaction

Returns a transaction by a user-defined transaction hash.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, optimism, polkadot, polygon, solana, stellar tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

hash
required
string
Default: "71d4f3412ec11128bbd9ce988d5bff2ec3bb6ea3953c8faf189d88ae49de9f7a"
Examples:
  • 71d4f3412ec11128bbd9ce988d5bff2ec3bb6ea3953c8faf189d88ae49de9f7a -
  • 0x6d550b76008d75d25a735d2d96c640cc13b7a711372557955fbd3b1cad8a78cb -

The transaction hash.

Responses

Response samples

Content type
application/json
{
  • "id": "71d4f3412ec11128bbd9ce988d5bff2ec3bb6ea3953c8faf189d88ae49de9f7a",
  • "block_id": "000000000000000000031911bca2ecf6c19ede467d81659f0c43a420ede1fd21",
  • "date": 1667882555,
  • "status": "completed",
  • "num_events": 4,
  • "meta": {
    },
  • "block_number": 762213,
  • "confirmations": 39001,
  • "events": [
    ]
}

Get a Transaction Output by Hash and Index

Get a transaction output by a user-defined transaction hash and the transaction output index.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: bitcoin, bitcoincash, dogecoin, litecoin.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

hash
required
string
Default: "71d4f3412ec11128bbd9ce988d5bff2ec3bb6ea3953c8faf189d88ae49de9f7a"
Examples:
  • 71d4f3412ec11128bbd9ce988d5bff2ec3bb6ea3953c8faf189d88ae49de9f7a -
  • 0x6d550b76008d75d25a735d2d96c640cc13b7a711372557955fbd3b1cad8a78cb -

The transaction hash.

index
required
integer
Default: 0

The transaction output index.

Responses

Response samples

Content type
application/json
{
  • "status": "mined",
  • "is_spent": true,
  • "spent": {
    },
  • "value": 81031,
  • "mined": {
    }
}

Get a List of Transaction Inputs and Outputs

Returns the transaction inputs and outputs following the BTC's UTXO model definition by a user-definied account address.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

The protocol handle, one of: bitcoin, bitcoincash, dogecoin, litecoin.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

address
required
string
Default: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
Examples:
  • 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa - BTC address

The account address of the protocol.

query Parameters
spent
boolean
Example: spent=true

Whether the transaction output was spent or not.

check_mempool
boolean
Example: check_mempool=true

Whether to check for UTXOs spent in the mempool as well as UTXOs pending in the mempool.

from
integer
Example: from=961846434

The Unix Timestamp from where to start.

to
integer
Example: to=1119612834

The Unix Timestamp from where to end.

order
string
Default: "desc"
Enum: "desc" "asc"

The pagination order.

page_token
string
Example: page_token=8185.123

The token to retrieve more items in the next request. Use the next_page_token returned from the previous response for this parameter.

page_size
integer
Example: page_size=1000

The max number of items to return in a response Defaults to 50k and is capped at 100k.

Responses

Response samples

Content type
application/json
{
  • "total": 25,
  • "data": [
    ],
  • "meta": {
    }
}

Get a List of Transactions for a Given Address

Returns the transactions that an address was involved with, from newest to oldest.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

The protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, optimism, polkadot, polygon, solana, tezos, stellar, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

address
required
string
Default: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
Examples:
  • 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa - BTC address

The account address of the protocol.

query Parameters
assets
string
Examples:
  • assets=ethereum/native/eth -
  • assets=ethereum/contract/0x0f5d2fb29fb7d3cfee444a200298f468908cc942/erc-20 -
  • assets=ethereum/native/eth,ethereum/contract/0x0f5d2fb29fb7d3cfee444a200298f468908cc942/erc-20 -

Comma-separated list of asset paths to filter. If the list is empty or all elements are empty, this filter has no effect. Filtering by asset is applicable only for:

  • Balances endpoints: algorand, avalanche, bitcoincash, ethereum, litecoin, optimism, polygon, polkadot, solana
  • Transactions endpoints: algorand, avalanche, ethereum

Find all the asset paths on this page.

from
integer
Example: from=961846434

Unix Timestamp from where to start. The date range is exclusive (results include transactions starting 1 second after this timestamp).

to
integer
Example: to=1119612834

Unix Timestamp from where to end. The date range is exclusive (results include transactions up to 1 second before this timestamp).

order
string
Default: "desc"
Enum: "desc" "asc"

The pagination order.

page_token
string
Example: page_token=8185.123

The token to retrieve more items in the next request. Use the next_page_token returned from the previous response for this parameter.

page_size
integer
Example: page_size=25

Max number of items to return in a response. Defaults to 25 and is capped at 100.

Responses

Response samples

Content type
application/json
{
  • "total": 25,
  • "data": [
    ],
  • "meta": {
    }
}

Get a List of Transactions

Get a List of transactions, starting with the lastest one. Each call returns an array of the entire list.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, litecoin, optimism, polkadot, stellar tezos, xrp.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

query Parameters
block_hash
string
Example: block_hash=0x2444165297806ad5598e4569e5823b3df0cde3e48b346781ab632fa6cef1a0ec

Filter by block hash. You can specify only one block hash at a time.

block_number
integer
Example: block_number=789387

Filter by block number.

assets
string
Examples:
  • assets=ethereum/native/eth -
  • assets=ethereum/contract/0x0f5d2fb29fb7d3cfee444a200298f468908cc942/erc-20 -
  • assets=ethereum/native/eth,ethereum/contract/0x0f5d2fb29fb7d3cfee444a200298f468908cc942/erc-20 -

Comma-separated list of asset paths to filter. If the list is empty or all elements are empty, this filter has no effect. Filtering by asset is applicable only for:

  • Balances endpoints: algorand, avalanche, bitcoincash, ethereum, litecoin, optimism, polygon, polkadot, solana
  • Transactions endpoints: algorand, avalanche, ethereum

Find all the asset paths on this page.

order
string
Default: "desc"
Enum: "desc" "asc"

The pagination order.

page_token
string
Example: page_token=8185.123

The token to retrieve more items in the next request. Use the next_page_token returned from the previous response for this parameter.

page_size
integer
Example: page_size=25

Max number of items to return in a response. Defaults to 25 and is capped at 100.

Responses

Response samples

Content type
application/json
{
  • "total": 2,
  • "data": [
    ],
  • "meta": {
    }
}

Create an Unsigned Transaction

Creates an unsigned transaction.

Note that Ethereum currently only supports singular transaction destinations.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: avalanche, bitcoin, ethereum, dogecoin, polkadot, polygon, solana.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

Request Body schema: application/json
required
from
required
string

The source UTXO or account ID for the originating funds.

required
Array of objects (tx_destination)

A list of recipients.

object

The contract object.

index
integer <int64>

The UTXO index or the account Nonce. Required for Bitcoin, Bitcoincash, and Litecoin.

fee
string

The fee you are willing to pay for the transaction. For Ethereum and Polygon see 'protocol.ethereum' and 'protocol.polygon'.

object (tx_create_protocol)

Protocol specific parameters for transaction creation.

Responses

Request samples

Content type
application/json
Example
{
  • "from": "0x035F67C6D401514f58E6b121bc38b161cCABF7B9",
  • "to": [
    ],
  • "index": 1010,
  • "protocol": {
    }
}

Response samples

Content type
application/json
{
  • "id": 5.116744060151016e+76,
  • "unsigned_tx": "e909843b9aca008252089481b7e08f65bdf5648606c89998a9cc81643976478601d1a94a200080808080",
  • "meta": {
    }
}

Submit a Signed Transaction

Submit a signed transaction to the network.

Note: A successful transaction may still be rejected on chain or not processed due to a too low fee. You can monitor successful transactions through Universal websockets.

Authorizations:
apiKeyAuthHeaderbearerAuth
path Parameters
protocol
required
string
Default: "bitcoin"
Examples:
  • bitcoin -

Protocol handle, one of: algorand, avalanche, bitcoin, bitcoincash, dogecoin, ethereum, litecoin, optimism, polkadot, polygon, solana.

network
required
string
Default: "mainnet"
Examples:
  • mainnet -
  • mainnet-c -
  • testnet -
  • testnet4 - Bitcoin testnet network
  • testnet-c -
  • holesky - Ethereum testnet network
  • hoodi - Ethereum testnet network
  • sepolia - Ethereum testnet network
  • westend - Polkadot testnet network
  • amoy - Polygon testnet network

Which network to target. Available networks can be found in the list of supported protocols or with /{protocol}.

Request Body schema: application/json
required
tx
required
string

The signed TX.

Responses

Request samples

Content type
application/json
{
  • "tx": "0100000001ca19af5fb94ced7e62b623d0039a398a42e60050405a1341efe475894629c131010000008b483045022100d77b002b3142013b3f825a730f5bc3ead2014266f07ba4449269af0cf6f086310220365bca1d616ba86fac42ad69efd5f92c5ed6cf16f27ebf5ab55010efc72c219d014104417eb0abe69db2eca63c84eb44266c29c24973dc81cde16ca86c9d923630cb5f797bae7d7fab13498e06146111356eb271da74add05ebda8f72ff2b2878fddb7ffffffff0410270000000000001976a914344a0f48ca150ec2b903817660b9b68b13a6702688ac204e0000000000001976a914344a0f48ca150ec2b903817660b9b68b13a6702688ac30750000000000001976a914344a0f48ca150ec2b903817660b9b68b13a6702688ac48710000000000001976a914d6fa8814924b480fa7ff903b5ef61100ab4d92fe88ac00000000"
}

Response samples

Content type
application/json
{
  • "id": "9c8ac345b443dd10a418ea0beaa320ef233dbae5590be2a11ac090e0e9839c1c"
}