Tx

Endpointhttps://api.sparkscan.io

Download schema

Operations related to transactions

GET

https://api.sparkscan.io

/v1/tx/latest

Get the latest network transactions across all addresses.

query Parameters

network

string · enum

Enum values:

MAINNET

REGTEST

limit

min: 1

Maximum number of transactions to return (default: 10, max: 250).

offset

min: 0

Number of transactions to skip.

sort

string · enum

Enum values:

created_at

updated_at

order

string · enum

Enum values:

asc

desc

from_timestamp

string

Filter transactions created after this ISO 8601 timestamp.

to_timestamp

string

Filter transactions created before this ISO 8601 timestamp.

Responses

Response for status 200

object[]

id

string · required

Spark transaction ID

type

string · enum · required

Enum values:

bitcoin_deposit

bitcoin_withdrawal

spark_transfer

lightning_payment

token_mint

token_transfer

token_burn

token_multi_transfer

status

string · enum · required

Enum values:

confirmed

pending

sent

failed

expired

valueUsd

number · required

USD value

GET/v1/tx/latest

curl --request GET \
  --url https://api.sparkscan.io/v1/tx/latest

shell

Example Responses

[
  {
    "id": "id",
    "type": "bitcoin_deposit",
    "status": "confirmed",
    "amountSats": 0,
    "tokenAmount": "string",
    "tokenMetadata": {
      "tokenIdentifier": "tokenIdentifier",
      "tokenAddress": "tokenAddress",
      "name": "name",
      "ticker": "ticker",
      "decimals": 0,
      "issuerPublicKey": "issuerPublicKey",
      "maxSupply": "string",
      "isFreezable": true
    },
    "multiIoDetails": {
      "inputs": [
        {
          "address": "address",
          "pubkey": "pubkey",
          "amount": "amount"
        }
      ],
      "outputs": [
        {
          "address": "address",
          "pubkey": "pubkey",
          "amount": "amount"
        }
      ],
      "totalInputAmount": "totalInputAmount",
      "totalOutputAmount": "totalOutputAmount"
    },
    "from": {
      "type": "spark",
      "identifier": "identifier",
      "pubkey": "string"
    },
    "to": {
      "type": "spark",
      "identifier": "identifier",
      "pubkey": "string"
    },
    "bitcoinTxid": "string",
    "valueUsd": 0,
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z",
    "expiredTime": "2024-08-25T15:00:00Z",
    "swapId": "string"
  }
]

json

application/json

GET

https://api.sparkscan.io

/v1/tx/{txid}

Get a transaction by its ID. Returns a sats transaction or token transaction depending on the type.

path Parameters

txid

string · required

The Spark transaction ID.

query Parameters

network

string · enum

Enum values:

MAINNET

REGTEST

Responses

Response for status 200

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: id, type, status +2 more
	type = object · requires: id, type, status +2 more

Properties for Variant 1:

id

string · required

Spark transaction ID

type

string · required

Transaction type

required

Transaction status

amountSats

integer · required

Amount in sats

valueUsd

number · required

USD value at time of transaction

GET/v1/tx/{txid}

curl --request GET \
  --url https://api.sparkscan.io/v1/tx/:txid

shell

Example Responses

{
  "id": "id",
  "type": "type",
  "status": "confirmed",
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z",
  "expiredTime": "2024-08-25T15:00:00Z",
  "from": {
    "type": "spark",
    "identifier": "identifier",
    "pubkey": "string"
  },
  "to": {
    "type": "spark",
    "identifier": "identifier",
    "pubkey": "string"
  },
  "amountSats": 0,
  "valueUsd": 0,
  "timeTakenSeconds": 0,
  "txid": "string",
  "bitcoinTxData": {
    "txid": "txid",
    "vin": [
      {
        "prevout": {},
        "witness": [
          "string"
        ],
        "value": 0
      }
    ],
    "vout": [
      {
        "scriptpubkey_address": "string",
        "value": 0
      }
    ],
    "status": {
      "confirmed": true,
      "block_height": 0,
      "block_time": 0
    },
    "fee": 0
  },
  "swapId": "string"
}

json

application/json

GET

https://api.sparkscan.io

/v1/address/{address}/transactions

Get paginated transactions for an address using offset-based pagination. For better performance on addresses with many transactions, use the v2 cursor-based endpoint.

path Parameters

address

string · required

The Spark address or public key hex

query Parameters

network

string · enum

Enum values:

MAINNET

REGTEST

limit

min: 1 · max: 100

Number of transactions per page (default: 25, max: 100)

offset

min: 0

Number of transactions to skip.

asset

string

sort

string · enum

Enum values:

created_at

updated_at

order

string · enum

Enum values:

asc

desc

from_timestamp

string

Filter transactions created after this ISO 8601 timestamp.

to_timestamp

string

Filter transactions created before this ISO 8601 timestamp.

Responses

Response for status 200

object · required

object[] · required

GET/v1/address/{address}/transactions

curl --request GET \
  --url https://api.sparkscan.io/v1/address/:address/transactions

shell

Example Responses

{
  "meta": {
    "totalItems": 0,
    "limit": 0,
    "offset": 0
  },
  "data": [
    {
      "id": "id",
      "type": "spark_transfer",
      "direction": "incoming",
      "counterparty": {
        "type": "spark",
        "identifier": "identifier",
        "tokenMetadata": {
          "tokenIdentifier": "tokenIdentifier",
          "tokenAddress": "tokenAddress",
          "name": "name",
          "ticker": "ticker",
          "decimals": 0,
          "issuerPublicKey": "issuerPublicKey",
          "maxSupply": "string",
          "isFreezable": true
        }
      },
      "amountSats": 0,
      "tokenAmount": "string",
      "valueUsd": 0,
      "createdAt": "2024-08-25T15:00:00Z",
      "updatedAt": "2024-08-25T15:00:00Z",
      "status": "confirmed",
      "txid": "string",
      "tokenMetadata": {
        "tokenIdentifier": "tokenIdentifier",
        "tokenAddress": "tokenAddress",
        "name": "name",
        "ticker": "ticker",
        "decimals": 0,
        "issuerPublicKey": "issuerPublicKey",
        "maxSupply": "string",
        "isFreezable": true
      },
      "multiIoDetails": {
        "inputs": [
          {
            "address": "address",
            "pubkey": "pubkey",
            "amount": "amount"
          }
        ],
        "outputs": [
          {
            "address": "address",
            "pubkey": "pubkey",
            "amount": "amount"
          }
        ],
        "totalInputAmount": "totalInputAmount",
        "totalOutputAmount": "totalOutputAmount"
      },
      "swapId": "string",
      "expiredTime": "2024-08-25T15:00:00Z"
    }
  ]
}

json

application/json

GET

https://api.sparkscan.io

/v1/tokens/{identifier}/transactions

Get paginated transactions for a specific token.

path Parameters

identifier

string · required

Token identifier (hex) or token address (bech32).

query Parameters

network

string · enum

Enum values:

MAINNET

REGTEST

limit

Maximum number of transactions to return (default: 25, max: 100).

offset

Number of results to skip.

Responses

Response for status 200

object · required

object[] · required

GET/v1/tokens/{identifier}/transactions

curl --request GET \
  --url https://api.sparkscan.io/v1/tokens/:identifier/transactions

shell

Example Responses

{
  "meta": {
    "totalItems": 0,
    "limit": 0,
    "offset": 0
  },
  "data": [
    {
      "id": "id",
      "type": "type",
      "status": "confirmed",
      "createdAt": "2024-08-25T15:00:00Z",
      "updatedAt": "2024-08-25T15:00:00Z",
      "expiredTime": "2024-08-25T15:00:00Z",
      "from": {
        "type": "spark",
        "identifier": "identifier",
        "pubkey": "string"
      },
      "to": {
        "type": "spark",
        "identifier": "identifier",
        "pubkey": "string"
      },
      "amount": "amount",
      "valueUsd": 0,
      "tokenMetadata": {
        "tokenIdentifier": "tokenIdentifier",
        "tokenAddress": "tokenAddress",
        "name": "name",
        "ticker": "ticker",
        "decimals": 0,
        "issuerPublicKey": "issuerPublicKey",
        "maxSupply": "string",
        "isFreezable": true
      },
      "multiIoDetails": {
        "inputs": [
          {
            "address": "address",
            "pubkey": "pubkey",
            "amount": "amount"
          }
        ],
        "outputs": [
          {
            "address": "address",
            "pubkey": "pubkey",
            "amount": "amount"
          }
        ],
        "totalInputAmount": "totalInputAmount",
        "totalOutputAmount": "totalOutputAmount"
      },
      "swapId": "string"
    }
  ]
}

json

application/json

GET

https://api.sparkscan.io

/v2/tx/latest

Get the latest network transactions. Includes expiredTime field for expired transactions.

query Parameters

network

string · enum

Enum values:

MAINNET

REGTEST

limit

min: 1

Maximum number of transactions to return (default: 10, max: 350).

offset

min: 0

Number of transactions to skip.

sort

string · enum

Enum values:

created_at

updated_at

order

string · enum

Enum values:

asc

desc

from_timestamp

string

Filter transactions created after this ISO 8601 timestamp.

to_timestamp

string

Filter transactions created before this ISO 8601 timestamp.

Responses

Response for status 200

object[]

id

string · required

Spark transaction ID

type

string · enum · required

Enum values:

bitcoin_deposit

bitcoin_withdrawal

spark_transfer

lightning_payment

token_mint

token_transfer

token_burn

token_multi_transfer

status

string · enum · required

Enum values:

confirmed

pending

sent

failed

expired

valueUsd

number · required

USD value

GET/v2/tx/latest

curl --request GET \
  --url https://api.sparkscan.io/v2/tx/latest

shell

Example Responses

[
  {
    "id": "id",
    "type": "bitcoin_deposit",
    "status": "confirmed",
    "amountSats": 0,
    "tokenAmount": "string",
    "tokenMetadata": {
      "tokenIdentifier": "tokenIdentifier",
      "tokenAddress": "tokenAddress",
      "name": "name",
      "ticker": "ticker",
      "decimals": 0,
      "issuerPublicKey": "issuerPublicKey",
      "maxSupply": "string",
      "isFreezable": true
    },
    "multiIoDetails": {
      "inputs": [
        {
          "address": "address",
          "pubkey": "pubkey",
          "amount": "amount"
        }
      ],
      "outputs": [
        {
          "address": "address",
          "pubkey": "pubkey",
          "amount": "amount"
        }
      ],
      "totalInputAmount": "totalInputAmount",
      "totalOutputAmount": "totalOutputAmount"
    },
    "from": {
      "type": "spark",
      "identifier": "identifier",
      "pubkey": "string"
    },
    "to": {
      "type": "spark",
      "identifier": "identifier",
      "pubkey": "string"
    },
    "bitcoinTxid": "string",
    "valueUsd": 0,
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z",
    "expiredTime": "2024-08-25T15:00:00Z",
    "swapId": "string"
  }
]

json

application/json

GET

https://api.sparkscan.io

/v2/tx/{txid}

Get a transaction by its ID. Returns a sats transaction or token transaction depending on the type.

path Parameters

txid

string · required

The Spark transaction ID.

query Parameters

network

string · enum

Enum values:

MAINNET

REGTEST

Responses

Response for status 200

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: id, type, status +2 more
	type = object · requires: id, type, status +2 more

Properties for Variant 1:

id

string · required

Spark transaction ID

type

string · required

Transaction type

required

Transaction status

amountSats

integer · required

Amount in sats

valueUsd

number · required

USD value at time of transaction

GET/v2/tx/{txid}

curl --request GET \
  --url https://api.sparkscan.io/v2/tx/:txid

shell

Example Responses

{
  "id": "id",
  "type": "type",
  "status": "confirmed",
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z",
  "expiredTime": "2024-08-25T15:00:00Z",
  "from": {
    "type": "spark",
    "identifier": "identifier",
    "pubkey": "string"
  },
  "to": {
    "type": "spark",
    "identifier": "identifier",
    "pubkey": "string"
  },
  "amountSats": 0,
  "valueUsd": 0,
  "timeTakenSeconds": 0,
  "txid": "string",
  "bitcoinTxData": {
    "txid": "txid",
    "vin": [
      {
        "prevout": {},
        "witness": [
          "string"
        ],
        "value": 0
      }
    ],
    "vout": [
      {
        "scriptpubkey_address": "string",
        "value": 0
      }
    ],
    "status": {
      "confirmed": true,
      "block_height": 0,
      "block_time": 0
    },
    "fee": 0
  },
  "swapId": "string"
}

json

application/json

Address

Variant

Matching Criteria

type = object · requires: id, type, status +2 more

Variant

Matching Criteria

type = object · requires: id, type, status +2 more