TransactionEntity

{
  "bridge": {
    "amount": "50",
    "direction": "out",
    "fee": "3",
    "other_chain_key": "ethereum",
    "other_chain_name": "Ethereum",
    "other_from_address": "0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed",
    "other_tx_explorer_url": "https://etherscan.io/tx/0x4be1…",
    "other_tx_hash": "0x4be1…",
    "received": "46.99",
    "state": "completed"
  },
  "created_at": "2026-08-07T10:00:00Z",
  "from_address": "0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed",
  "id": 90231,
  "txid_explorer_url": "https://polygonscan.com/tx/0x9f2c…",
  "type": "trade",
  "address": "0xE1188438C85C98aADFf1a88f97764E607B4978C3",
  "beneficiary_id": 12,
  "blockchain_key": "polygon-mainnet",
  "blockchain_name": "Polygon",
  "change_voucher_amount": "0",
  "change_voucher_expiry": "2026-09-01T00:00:00Z",
  "change_voucher_pin": "—",
  "credit_amount": "40.00",
  "credit_currency": "usdc",
  "debit_amount": "60.00",
  "debit_currency": "usdc",
  "description": "Bought 100 YES @ 0.60",
  "event_id": 45,
  "event_image_url": "https://cdn.calibri.io/events/btc.png",
  "event_title": "Bitcoin 5-minute",
  "executor_address": "0x7830c87c02e56aff27fa8ab1241711331fa86f43",
  "expires_at": "2026-08-08T00:00:00Z",
  "fee": "0.17",
  "fee_currency": "usdc",
  "initiated_from": "web",
  "market_id": "12",
  "market_title": "Will BTC close above its open?",
  "member_description": "my hedge",
  "on_chain": true,
  "order_id": 90231,
  "origin_volume": "100",
  "paid_at": "2026-08-07T10:00:05Z",
  "payment_method_icon_url": "—",
  "payment_method_name": "—",
  "payment_method_precision": 2,
  "payment_method_provider": "—",
  "price": "0.60",
  "quote_currency": "usdc",
  "receiver": "0x0DECE7d83f8D47CD8dD8278c0F22c361C58577BD",
  "reference_id": 90231,
  "reference_type": "Order",
  "sender": "0xE1188438C85C98aADFf1a88f97764E607B4978C3",
  "settlement_status": "confirmed",
  "side": "yes",
  "state": "active",
  "txid": "0x9f2c…",
  "updated_at": "2026-08-07T10:05:00Z",
  "voucher_pin": "—"
}

bridge

object

required

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

Show child attributes

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"

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:

"—"

Getting Started

Streaming

Endpoints

Models

TransactionEntity