GET /v1/transactions — Your Balance Ledger

GET

transactions

Your balance ledger

curl --request GET \
  --url https://csboard.com/v1/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://csboard.com/v1/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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 := "https://csboard.com/v1/transactions"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/transactions")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "<string>",
      "type": "purchase",
      "amount_usd": -1.28,
      "balance_after_usd": 428.18,
      "created_at": "2023-11-07T05:31:56Z",
      "order_id": "<string>",
      "order_kind": "buy"
    }
  ],
  "meta": {
    "next_cursor": "<string>",
    "per_page": 123
  }
}

{
  "code": "<string>",
  "detail": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>"
}

{
  "code": "rate_limit_exceeded",
  "detail": "Read rate limit of 100 requests/min exceeded. The counter restarts in 23 s. For new listings use GET /v1/listings/stream instead of polling.",
  "bucket": "read",
  "limit_per_min": 100,
  "retry_after_sec": 23
}

The transactions endpoint is your money ledger: one row per movement on your balance, newest first. It is the endpoint to reconcile against — a failed purchase and the refund that made you whole are two rows carrying the same order_id. Authentication required. Send your key as Authorization: Bearer csb_pub_.... Any valid key works; the trading flag is not needed.

A cancelled or failed order is always refunded, and the credit usually lands within seconds. You do not need to poll this endpoint to find out whether a refund happened — the order itself carries a refund object. Use /v1/transactions when you want the full money trail: bookkeeping, an internal statement, or an end-of-day reconciliation.

Query parameters

integer

default:"50"

Results per page. Minimum 1, maximum 100.

string

Filter by movement type. One of: purchase, refund, sale, deposit, withdrawal, bonus, fee.

integer

Only return entries created at or after this Unix timestamp (seconds).

integer

Only return entries created at or before this Unix timestamp (seconds).

string

Keyset cursor from a previous response’s meta.next_cursor. Pass it to fetch the next page.

Response fields

Transaction[]

required

Array of ledger entries for this page.

Show Transaction object

string

required

Ledger entry id.

string

required

What moved the money. One of: purchase, refund, sale, deposit, withdrawal, bonus, fee, adjustment.

number

required

Signed. Negative means money left your balance, positive means it came in.

number

required

Your balance immediately after this entry.

string | null

The order this movement belongs to. null for movements that are not tied to an order (a deposit, a bonus).

string | null

Whether order_id refers to a buy or a sell order.

datetime

required

ISO 8601 timestamp.

object

required

Show meta object

string | null

required

Pass back as cursor to fetch the next page. null on the last page.

integer

required

Page size used for this response.

Example request

curl "https://csboard.com/v1/transactions?type=refund&limit=50" \
  -H "Authorization: Bearer csb_pub_..."

Example response

A purchase that could not be delivered, and its refund — same order_id, seconds apart:

{
  "data": [
    {
      "id": "tx_01J9Z3M2A7",
      "type": "refund",
      "amount_usd": 1.28,
      "balance_after_usd": 429.46,
      "order_id": "cmrkm405x0709yj01b8lmzk62",
      "order_kind": "buy",
      "created_at": "2026-07-14T12:13:15Z"
    },
    {
      "id": "tx_01J9Z3M1Q4",
      "type": "purchase",
      "amount_usd": -1.28,
      "balance_after_usd": 428.18,
      "order_id": "cmrkm405x0709yj01b8lmzk62",
      "order_kind": "buy",
      "created_at": "2026-07-14T12:13:15Z"
    }
  ],
  "meta": { "next_cursor": "eyJ0IjoiMjAyNi0wNy0xNFQxMjoxMzoxNVoifQ==", "per_page": 50 }
}

Reconciling a day

Walk the ledger with the cursor and sum by type — purchases and refunds net out against the orders you know:

import requests

HEADERS = {"Authorization": "Bearer csb_pub_..."}
cursor, totals = None, {}

while True:
    r = requests.get(
        "https://csboard.com/v1/transactions",
        params={"limit": 100, "start_unix_time": 1752451200, "cursor": cursor},
        headers=HEADERS,
    ).json()

    for tx in r["data"]:
        totals[tx["type"]] = round(totals.get(tx["type"], 0) + tx["amount_usd"], 2)

    cursor = r["meta"]["next_cursor"]
    if not cursor:
        break

print(totals)  # {'purchase': -524.89, 'refund': 65.09, ...}

Error codes

HTTP status	Code	Meaning
401	`missing_api_key` / `invalid_api_key`	Missing or invalid API key.
422	`invalid_request`	Invalid query parameters (unknown `type`, bad cursor, `limit` out of range).
429	`rate_limit_exceeded`	Too many requests. Back off for the `Retry-After` header value.

Authorizations

Authorization

string

header

required

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Bucket for the bucket the call spent. See Rate limits.

Query Parameters

limit

integer

default:50

Results per page. 1–100. Default 50.

Required range: 1 <= x <= 100

type

enum<string>

Filter by movement type.

Available options:

purchase,

refund,

sale,

deposit,

withdrawal,

bonus,

fee

start_unix_time

integer

Only entries created at or after this Unix timestamp (seconds).

end_unix_time

integer

Only entries created at or before this Unix timestamp (seconds).

cursor

string

Keyset cursor from a previous response's meta.next_cursor.

Response

A page of ledger entries.

data

object[]

Show child attributes

meta

object

Show child attributes

Your balance ledger

curl --request GET \
  --url https://csboard.com/v1/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://csboard.com/v1/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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 := "https://csboard.com/v1/transactions"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/transactions")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "<string>",
      "type": "purchase",
      "amount_usd": -1.28,
      "balance_after_usd": 428.18,
      "created_at": "2023-11-07T05:31:56Z",
      "order_id": "<string>",
      "order_kind": "buy"
    }
  ],
  "meta": {
    "next_cursor": "<string>",
    "per_page": 123
  }
}

{
  "code": "<string>",
  "detail": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>"
}

{
  "code": "rate_limit_exceeded",
  "detail": "Read rate limit of 100 requests/min exceeded. The counter restarts in 23 s. For new listings use GET /v1/listings/stream instead of polling.",
  "bucket": "read",
  "limit_per_min": 100,
  "retry_after_sec": 23
}

Market Data

Trading

Instant Sell

P2P

Account

Webhooks

Status

GET /v1/transactions — Your Balance Ledger

Query parameters

Response fields

Example request

Example response

Reconciling a day

Error codes

Authorizations

Query Parameters

Response

​Query parameters

​Response fields

​Example request

​Example response

​Reconciling a day

​Error codes

Authorizations

Query Parameters

Response

Query parameters

Response fields

Example request

Example response

Reconciling a day

Error codes