Skip to main content
GET
/
transactions
List transactions
curl --request GET \
  --url https://api.conduit.financial/v2/transactions \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "customerId": "<string>",
      "source": {
        "type": "wallet",
        "walletId": "<string>",
        "address": "<string>",
        "assetAmount": {
          "code": "USDC",
          "chain": "ethereum",
          "amount": "100"
        }
      },
      "destination": {
        "type": "wallet",
        "walletId": "<string>",
        "address": "<string>",
        "assetAmount": {
          "code": "USDC",
          "chain": "ethereum",
          "amount": "100"
        }
      },
      "fees": [
        {
          "code": "FIXED_FEE",
          "type": "fixed",
          "assetAmount": {
            "code": "USDC",
            "chain": "ethereum",
            "amount": "100"
          }
        }
      ],
      "createdAt": "2026-01-15T09:30:00.000Z",
      "type": "deposit",
      "customerName": "<string>",
      "clientReferenceId": "<string>",
      "completedAt": "2026-01-15T09:30:00.000Z",
      "failureMessage": "<string>",
      "cancelledAt": "2026-01-15T09:30:00.000Z",
      "linkedOrderId": "<string>"
    }
  ],
  "meta": {
    "mode": "cursor",
    "nextCursor": "eyJpZCI6ImN1c18yeFBxTjhSIn0",
    "previousCursor": null,
    "total": 42
  }
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
cursor
string

Opaque cursor from a previous response to fetch the next page

​
limit
number
default:20

Maximum number of results to return (1-100)

Required range: 1 <= x <= 100
​
direction
enum<string>

Pagination direction relative to the cursor

Available options:
forward,
backward
​
type
string[]
​
status
enum<string>[]
Available options:
pending,
processing,
completed,
failed,
cancelled
​
customerId
string
​
linkedOrderId
string
​
asset
enum<string>
Available options:
USD,
EUR,
GBP,
CHF,
JPY,
CAD,
AUD,
NZD,
SGD,
HKD,
CNY,
KRW,
INR,
BRL,
MXN,
ARS,
CLP,
COP,
PEN,
ZAR,
NGN,
KES,
GHS,
EGP,
AED,
SAR,
ILS,
TRY,
PLN,
CZK,
HUF,
SEK,
NOK,
DKK,
THB,
IDR,
MYR,
PHP,
VND,
TWD,
USDC,
USDT,
DAI,
EURC,
PYUSD,
BTC,
ETH,
SOL,
TRX
​
chain
enum<string>
Available options:
ETHEREUM,
BASE,
SOLANA,
POLYGON,
ARBITRUM,
OPTIMISM,
AVALANCHE,
TRON,
STELLAR,
BSC,
BITCOIN
​
txHash
string
​
clientReferenceId
string
​
createdAfter
string
​
createdBefore
string
​
sortBy
enum<string>
Available options:
createdAt,
updatedAt
​
sortOrder
enum<string>
Available options:
asc,
desc

Response

​
data
object[]
required

Unified client-facing transaction view across deposit / withdrawal / onramp / offramp. Discriminated by type.

​
meta
object
required