Skip to main content
Preview Documentation — This integration is in final testing. API shapes are stable; endpoints will be live shortly. Contact your RebelFi rep if you have questions before go-live.

List Transactions

Returns transactions with filtering and pagination.
GET /v1/ramp/transactions

Query Parameters

customer_id
integer
Filter by merchant ID
status
string
Filter by status: pending, processing, in_progress, awaiting_confirmation, broadcasted, completed, failed, rejected, timed_out, canceled, reversed
date_from
string
Filter from date (ISO 8601)
date_to
string
Filter to date (ISO 8601)
page
integer
default:"1"
Page number
per_page
integer
default:"20"
Results per page (max 100)
curl "https://api.rebelfi.io/v1/ramp/transactions?customer_id=1&status=completed&page=1" \
  -H "x-api-key: your_api_key"

Response

{
  "data": [
    {
      "id": 1,
      "customer_id": 1,
      "customer_name": "OnEdge",
      "usd_amount": "50000",
      "total_fee": "125",
      "developer_fee": "25",
      "usdc_delivered": "49875",
      "status": "completed",
      "created_at": "2026-03-20T14:30:00Z",
      "completed_at": "2026-03-20T14:35:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 156
  }
}
id
number
Transaction identifier
customer_id
number
Merchant ID this transaction belongs to
customer_name
string
Merchant name
usd_amount
string
USD amount deposited
total_fee
string
Total fee deducted (in USD)
developer_fee
string
Your platform’s fee portion (in USD)
usdc_delivered
string
USDC amount delivered to your wallet
status
string
Current transaction status
created_at
string
ISO 8601 timestamp when the transaction was created
completed_at
string
ISO 8601 timestamp when USDC was delivered (only present for completed transactions)

Get Transaction

Returns a single transaction with full status history.
GET /v1/ramp/transactions/{id}
id
integer
required
Transaction ID
curl "https://api.rebelfi.io/v1/ramp/transactions/1" \
  -H "x-api-key: your_api_key"

Response

{
  "id": 1,
  "customer_id": 1,
  "customer_name": "OnEdge",
  "usd_amount": "50000",
  "total_fee": "125",
  "developer_fee": "25",
  "usdc_delivered": "49875",
  "status": "completed",
  "status_history": [
    { "status": "pending", "timestamp": "2026-03-20T14:30:00Z" },
    { "status": "processing", "timestamp": "2026-03-20T14:31:00Z" },
    { "status": "broadcasted", "timestamp": "2026-03-20T14:34:00Z" },
    { "status": "completed", "timestamp": "2026-03-20T14:35:00Z" }
  ],
  "created_at": "2026-03-20T14:30:00Z",
  "completed_at": "2026-03-20T14:35:00Z"
}

Transaction Statuses

StatusDescription
pendingDeposit detected, conversion not started
processingConversion in progress
in_progressConversion actively executing
awaiting_confirmationWaiting for blockchain confirmation
broadcastedUSDC transaction broadcasted to chain
completedUSDC delivered to your wallet
failedConversion failed
rejectedTransaction rejected
timed_outTransaction timed out
canceledTransaction canceled
reversedDeposit reversed — funds returned to sender