Transaction History

Returns fill-level transaction records for your account. Each fill represents a single provider execution within an order, including the on-chain transaction ID.

GET/api/v1/historyRequires authentication

Query parameters

periodstringOPTIONAL

Time period to retrieve history forOne of: 7D30D90DDefault: 7D

Request examples

curl "https://merx.exchange/api/v1/history?period=30D" \
  -H "X-API-Key: sk_live_your_key_here"

Response

Returns an array of fill objects sorted by creation time descending. Each fill corresponds to a single provider execution and includes the on-chain transaction hash when confirmed.

200Success

[
  {
    "id": "fill_x1y2z3",
    "order_id": "ord_abc123",
    "provider": "powersun",
    "quoted_provider": "catfee",
    "order_quoted_cost_sun": 1560000,
    "order_credit_sun": 0,
    "order_net_paid_sun": 1560000,
    "amount": 65000,
    "price_sun": 23,
    "cost_sun": 1495000,
    "tx_id": "a1b2c3d4e5f6...0987654321",
    "created_at": "2026-03-29T10:15:00.000Z",
    "confirmed_at": "2026-03-29T10:15:04.000Z",
    "resource_type": "ENERGY"
  },
  {
    "id": "fill_a4b5c6",
    "order_id": "ord_def456",
    "provider": "powersun",
    "quoted_provider": "powersun",
    "order_quoted_cost_sun": 3100000,
    "order_credit_sun": 0,
    "order_net_paid_sun": 3100000,
    "amount": 100000,
    "price_sun": 31,
    "cost_sun": 3100000,
    "tx_id": "f6e5d4c3b2a1...1234567890",
    "created_at": "2026-03-28T14:30:00.000Z",
    "confirmed_at": "2026-03-28T14:30:06.000Z",
    "resource_type": "ENERGY"
  }
]

Response fields

idstringUnique fill identifier

order_idstringParent order identifier

providerstringProvider that fulfilled this portion

quoted_providerstring | nullProvider whose offer set the customer quote

order_quoted_cost_sunnumberGross resource quote for the whole order in SUN

order_credit_sunnumberService credit applied once to the whole order in SUN

order_net_paid_sunnumberNet resource amount paid for the whole order in SUN

amountnumberAmount of resource in this fill

price_sunnumberPrice per unit in SUN

cost_sunnumberTotal cost of this fill in SUN

tx_idstringOn-chain transaction hash

created_atstringISO 8601 timestamp when the fill was created

confirmed_atstringISO 8601 timestamp when on-chain confirmation received

resource_typestringENERGY or BANDWIDTH