Balance updates

Creates asynchronous job for retrieving balance updates data. Both start_* and end_* parameters must be specified (time or height). Use the /jobs endpoint to poll job's status. The result file when downloaded will contain a newline-delimited JSON stream of BlockchainJobBalanceUpdate objects.

put

Authorizations

api_key

api_keystringRequired

Coin Metrics API key can be specified as ?api_key= query parameter.

Body

application/x-www-form-urlencoded

assetsanyRequired

Comma separated list of assets, or wildcard (*) for all supported assets.

accountsstring[]Required

Account ids. For ETH_CL, this can either be a validator public key or a validator index.

start_timestring · date-timeOptional

Start of the time interval.
Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z, 2006-01-20T00:00:00.000Z, 2006-01-20T00:00:00.123456Z, 2006-01-20T00:00:00.123456789Z, 2006-01-20, 20060120.
Inclusive by default. Mutually exclusive with start_height/end_height and start_slot/end_slot.
When specified, end_time parameter is mandatory.
UTC timezone by default. Z suffix is optional.

end_timestring · date-timeOptional

End of the time interval.
Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z, 2006-01-20T00:00:00.000Z, 2006-01-20T00:00:00.123456Z, 2006-01-20T00:00:00.123456789Z, 2006-01-20, 20060120.
Inclusive by default. Mutually exclusive with start_height/end_height and start_slot/end_slot.
When specified, start_time parameter is mandatory.
UTC timezone by default. Z suffix is optional.

start_heightinteger · int64Optional

The start height indicates the beginning block height for the set of data that are returned.
Inclusive by default. Mutually exclusive with start_time/end_time and start_slot/end_slot.
When specified, end_height parameter is mandatory.
Not compatible with requests containing more than one asset.

end_heightinteger · int64Optional

The end height indicates the ending block height for the set of data that are returned.
Inclusive by default. Mutually exclusive with start_time/end_time and start_slot/end_slot.
When specified, start_height parameter is mandatory.
Not compatible with requests containing more than one asset.

start_slotinteger · int64Optional

The start slot indicates the beginning slot for the set of data that are returned.
Inclusive by default. Mutually exclusive with start_time/end_time and start_height/end_height.
When specified, end_slot parameter is mandatory.
Not compatible with requests containing more than one asset.

end_slotinteger · int64Optional

The end slot indicates the ending slot for the set of data that are returned.
Inclusive by default. Mutually exclusive with start_time/end_time and start_height/end_height.
When specified, start_slot parameter is mandatory.
Not compatible with requests containing more than one asset.

Responses

200

Details of just created job.

application/json

job_idstringRequired

Job ID.

job_urlstringRequired

Job URL.

401

Requested resource requires authorization.

application/json

403

Requested resource is not available with supplied credentials.

application/json

put/blockchain-job/balance-updates

ShellPython

curl -X PUT --compressed "https://api.coinmetrics.io/v4/blockchain-job/balance-updates?api_key=<your_key>" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "assets=sol" \
  --data-urlencode "accounts=account1,account2" \
  --data-urlencode "start_time=2023-07-04T00:00:00.000000000Z" \
  --data-urlencode "end_time=2024-07-04T00:00:00.000000000Z"

{
  "job_id": "ZjRjZDE2N2EtYzljYy00MjQ5LTk4ZWYtOTlkZDljZTE1ZDU3OjgzNTZkODQyLTA5ODMtNGM2NC1hMGE5LWY5MzBhZTMxODFiZg",
  "job_url": "https://api.coinmetrics.io/v4/jobs?api_key=<your_key>&ids=ZjRjZDE2N2EtYzljYy00MjQ5LTk4ZWYtOTlkZDljZTE1ZDU3OjgzNTZkODQyLTA5ODMtNGM2NC1hMGE5LWY5MzBhZTMxODFiZg"
}