Skip to main content
GET
Transaction history

Authorizations

X-Auth-Apikey
string
header
required

HMAC-signed API key. Send X-Auth-Apikey, X-Auth-Nonce and X-Auth-Signature.

Query Parameters

limit
integer
default:50

Entries per page, 1–1000. Defaults to 50.

Required range: 1 <= x <= 1000
page
integer
default:1

Page number, from 1. Read Total off the response headers.

Required range: x >= 1
order_by
enum<string>
default:desc

Sort direction on the entry timestamp. Defaults to desc.

Available options:
asc,
desc
time_to
number

Upper bound, Unix SECONDS.

time_from
number

Lower bound, Unix SECONDS — not milliseconds, and not ISO-8601. A millisecond value lands far in the future and returns nothing rather than erroring.

txid
string

Find the entry for one on-chain transaction.

type
enum<string>

Filter by what produced the entry.

Available options:
deposit,
withdraw,
internal_transfer,
trade,
referral,
referral_reward,
maker_reward,
lp_reward
currency
string

Filter to one asset. Matches either side of the entry, credit or debit.

Response

200 - application/json
bridge
object
required

Deposits and withdrawals that crossed chains: the other side of the bridge. null otherwise.

created_at
string
required

ISO-8601.

Example:

"2026-08-07T10:00:00Z"

from_address
string | null
required

Deposits: the address that sent it (lowercase). null for other entries or when not recorded.

Example:

"0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed"

id
number
required
Example:

90231

txid_explorer_url
string | null
required

Deposits and withdrawals: the full block-explorer URL of txid, on the chain that transaction is actually on (for a wallet deposit or withdrawal always Polygon, even when blockchain_key names the network a cross-chain withdrawal went to). null for other entries, or when there is no txid or explorer.

Example:

"https://polygonscan.com/tx/0x9f2c…"

type
string
required

One of trade, referral, maker_reward.

Example:

"trade"

address
string

Address involved, for an on-chain row.

Example:

"0xE1188438C85C98aADFf1a88f97764E607B4978C3"

beneficiary_id
number

Custodial funding only — not used on Calibri.

Example:

12

blockchain_key
string
Example:

"polygon-mainnet"

blockchain_name
string
Example:

"Polygon"

change_voucher_amount
string

Voucher flow — not used on Calibri.

Example:

"0"

change_voucher_expiry
string

Voucher flow — not used on Calibri.

Example:

"2026-09-01T00:00:00Z"

change_voucher_pin
string

Voucher flow — not used on Calibri.

Example:

"—"

credit_amount
string
Example:

"40.00"

credit_currency
string

Currency received.

Example:

"usdc"

debit_amount
string
Example:

"60.00"

debit_currency
string

Currency sent.

Example:

"usdc"

description
string

System-generated summary.

Example:

"Bought 100 YES @ 0.60"

event_id
number
Example:

45

event_image_url
string
Example:

"https://cdn.calibri.io/events/btc.png"

event_title
string
Example:

"Bitcoin 5-minute"

executor_address
string

The address that submitted the transaction.

Example:

"0x7830c87c02e56aff27fa8ab1241711331fa86f43"

expires_at
string

ISO-8601.

Example:

"2026-08-08T00:00:00Z"

fee
string

The taker fee on this fill.

Example:

"0.17"

fee_currency
string
Example:

"usdc"

initiated_from
string

Where the movement originated.

Example:

"web"

market_id
string

Market this row belongs to.

Example:

"12"

market_title
string
Example:

"Will BTC close above its open?"

member_description
string

Your own note against this row.

Example:

"my hedge"

on_chain
boolean

Whether the row corresponds to an on-chain movement.

Example:

true

order_id
string
Example:

90231

origin_volume
string

Original order volume.

Example:

"100"

paid_at
string

When the movement completed. ISO-8601.

Example:

"2026-08-07T10:00:05Z"

payment_method_icon_url
string

Payment-provider flow — not used on Calibri.

Example:

"—"

payment_method_name
string

Payment-provider flow — not used on Calibri.

Example:

"—"

payment_method_precision
number

Payment-provider flow — not used on Calibri.

Example:

2

payment_method_provider
string

Payment-provider flow — not used on Calibri.

Example:

"—"

price
string

Fill price.

Example:

"0.60"

quote_currency
string

Settlement currency for the market.

Example:

"usdc"

receiver
string
Example:

"0x0DECE7d83f8D47CD8dD8278c0F22c361C58577BD"

reference_id
number
Example:

90231

reference_type
string

Related entity type.

Example:

"Order"

sender
string
Example:

"0xE1188438C85C98aADFf1a88f97764E607B4978C3"

settlement_status
string

On-chain mint badge, where the row came from a contract.

Example:

"confirmed"

side
enum<string>

Which leg, for a trade.

Available options:
yes,
no
Example:

"yes"

state
string
Example:

"active"

txid
string

Blockchain txid or internal reference.

Example:

"0x9f2c…"

updated_at
string

ISO-8601.

Example:

"2026-08-07T10:05:00Z"

voucher_pin
string

Voucher flow — not used on Calibri.

Example:

"—"