Buckets

Merged history (page 1, or filtered)

Newest first; a move between its own addresses nets out to its fee. With any history filter, the filtered form, paged by cursor, as JSON or CSV. A cursor stays valid across membership changes unless they touch blocks the walk has passed (409: start again).

get/buckets/{bucket}/transactions

Request

  • Base URL: https://sochain.com/api/v3
  • URL: https://sochain.com/api/v3/buckets/{bucket}/transactions
  • Auth: one of:
    • API key in header API-KEY
    • API key in query parameter api_key

Path parameters

bucketstring required

Letters, numbers, - and _, up to 64 characters. Unique within your account.

Query parameters

from_heightinteger

History filter: from this block on (inclusive).

to_heightinteger

History filter: up to this block (inclusive).

from_timestring
Example:2025-12-31

History filter: from this time on. Unix seconds, a UTC date (from its first second) or an RFC 3339 timestamp.

to_timestring
Example:2025-12-31

History filter: up to this time. Unix seconds, a UTC date (to its last second) or an RFC 3339 timestamp. Times map to the blocks they cover, so back-to-back ranges neither overlap nor leave a gap.

direction'in' | 'out' | 'both'

History filter: in (the balance went up), out (it went down) or both. By the net amount: a payment out with change back counts once, as out.

unconfirmed'include' | 'exclude' | 'only'

History filter: pending transactions. Default include, or exclude when the range has an end (to_height or to_time), which can't be combined with include or only.

page_sizeinteger

Rows per page of the filtered form: 1–100 (default 10); with format=csv 1–500 (default 500).

cursorstring

next_cursor from the previous page of the filtered form. It carries the filters, so it can be sent on its own.

format'json' | 'csv'

json (default) or csv. CSV has one row per transaction (time_utc, block, txid, direction, received, sent, net, price_usd, net_usd); the next page's URL is in the Link header.

currency'AUD' | 'BRL' | 'CAD' | 'CHF' | 'CNY' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KRW' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'PHP' | 'PLN' | 'RON' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'USD' | 'ZAR'

Prices in this currency instead of US dollars (any case). Not a filter: on the paged endpoints it keeps the form you'd get without it.

Response

Success.

status'success' required

Example response

{
  "data": {
    "transactions": [
      {
        "value_received": "0.00024300",
        "value_sent": "0.00024300",
        "balance_change": "0.00024300",
        "price": {
          "value": "0.00024300"
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.