Skip to main content
POST
/
balances-snapshots
Balance snapshots
curl --request POST \
  --url http://localhost:5001/balances-snapshots \
  --header 'X-blnk-key: <api-key>'
import requests

url = "http://localhost:5001/balances-snapshots"

headers = {"X-blnk-key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)
const options = {method: 'POST', headers: {'X-blnk-key': '<api-key>'}};

fetch('http://localhost:5001/balances-snapshots', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_PORT => "5001",
CURLOPT_URL => "http://localhost:5001/balances-snapshots",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-blnk-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "http://localhost:5001/balances-snapshots"

req, _ := http.NewRequest("POST", url, nil)

req.Header.Add("X-blnk-key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("http://localhost:5001/balances-snapshots")
.header("X-blnk-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("http://localhost:5001/balances-snapshots")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["X-blnk-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
Use blnk.ledger_balances.create_snapshot to trigger balance snapshot processing on demand.
1

Call the method

blnk.ledger_balances.create_snapshot
response = blnk.ledger_balances.create_snapshot({
  "batch_size": 500,
})
FieldTypeDescription
batch_sizenumberOptional. Server default is 1000.
2

Wait for completion

Snapshot jobs run asynchronously. Core returns immediately with a status message while processing continues in the background.
3

Response

200 OK
{
  "message": "Snapshotting in progress. should be completed shortly"
}
FieldTypeDescription
messagestrStatus message when the snapshot job starts.

How balance snapshots work

When Core runs snapshots and why they matter.

Balance snapshots

HTTP request and response schema.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.