Sparkscan API

Historical

Endpointhttps://api.sparkscan.io

Operations related to historical data

GET

https://api.sparkscan.io

/v2/historical/sats/balances/{address}

Fetches the hourly sats balances for an address. Currently available on the free plan but will be limited to enterprise users in the future.

path Parameters

address

string · required

The address to fetch the sats balances for.

query Parameters

network

string · enum · required

Enum values:

MAINNET

REGTEST

direction

string · enum

Enum values:

forward

backward

from

The start date to fetch the data from.

to

The end date to fetch the data to.

cursor

string

Pagination cursor from previous response.

limit

number · min: 1 · max: 48

Number of results per page (default: 12, max: 48).

Responses

Response for status 200

object[] · required

required

GET/v2/historical/sats/balances/{address}

curl --request GET \
  --url 'https://api.sparkscan.io/v2/historical/sats/balances/:address?network=%3Cstring%3E'

shell

Example Responses

{
  "data": [
    {
      "t": 0,
      "b": "b"
    }
  ],
  "nextCursor": "string"
}

json

application/json

GET

https://api.sparkscan.io

/v2/historical/tokens/balances/{address}/{tokenIdentifier}

Fetches the hourly tokens balances for an address and token identifier. Currently available on the free plan but will be limited to enterprise users in the future.

path Parameters

address

string · required

The address to fetch the tokens balances for.

tokenIdentifier

string · required

The token identifier to fetch the tokens balances for.

query Parameters

network

string · enum · required

Enum values:

MAINNET

REGTEST

direction

string · enum

Enum values:

forward

backward

from

to

cursor

string

Pagination cursor from previous response.

limit

number · min: 1 · max: 48

Number of results per page (default: 12, max: 48).

Responses

Response for status 200

object[] · required

required

GET/v2/historical/tokens/balances/{address}/{tokenIdentifier}

curl --request GET \
  --url 'https://api.sparkscan.io/v2/historical/tokens/balances/:address/:tokenIdentifier?network=%3Cstring%3E'

shell

Example Responses

{
  "data": [
    {
      "t": 0,
      "b": "b"
    }
  ],
  "nextCursor": "string"
}

json

application/json

Sats

Sparkscan API

Historical

Endpointhttps://api.sparkscan.io

Download schema

Operations related to historical data

GET

https://api.sparkscan.io

/v2/historical/sats/balances/{address}

Fetches the hourly sats balances for an address. Currently available on the free plan but will be limited to enterprise users in the future.

path Parameters

address

string · required

The address to fetch the sats balances for.

query Parameters

network

string · enum · required

Enum values:

MAINNET

REGTEST

direction

string · enum

Enum values:

forward

backward

from

The start date to fetch the data from.

to

The end date to fetch the data to.

cursor

string

Pagination cursor from previous response.

limit

number · min: 1 · max: 48

Number of results per page (default: 12, max: 48).

Responses

Response for status 200

object[] · required

required

GET/v2/historical/sats/balances/{address}

curl --request GET \
  --url 'https://api.sparkscan.io/v2/historical/sats/balances/:address?network=%3Cstring%3E'

shell

Example Responses

{
  "data": [
    {
      "t": 0,
      "b": "b"
    }
  ],
  "nextCursor": "string"
}

json

application/json

GET

https://api.sparkscan.io

/v2/historical/tokens/balances/{address}/{tokenIdentifier}

Fetches the hourly tokens balances for an address and token identifier. Currently available on the free plan but will be limited to enterprise users in the future.

path Parameters

address

string · required

The address to fetch the tokens balances for.

tokenIdentifier

string · required

The token identifier to fetch the tokens balances for.

query Parameters

network

string · enum · required

Enum values:

MAINNET

REGTEST

direction

string · enum

Enum values:

forward

backward

from

to

cursor

string

Pagination cursor from previous response.

limit

number · min: 1 · max: 48

Number of results per page (default: 12, max: 48).

Responses

Response for status 200

object[] · required

required

GET/v2/historical/tokens/balances/{address}/{tokenIdentifier}

curl --request GET \
  --url 'https://api.sparkscan.io/v2/historical/tokens/balances/:address/:tokenIdentifier?network=%3Cstring%3E'

shell

Example Responses

{
  "data": [
    {
      "t": 0,
      "b": "b"
    }
  ],
  "nextCursor": "string"
}

json

application/json

Sats