List transactions
Keyset paginated, newest first, both directions merged. `next_cursor` is present only on a full page. Filtering is server-side: a page filtered after it arrives is filtered against fifty rows, not against your history.
Authorization
KeyID Timestamp Nonce Signature Your key id, gyv_k_live_... or gyv_k_sandbox_....
In: header
Unix seconds. Must be within 5 minutes of our clock.
In: header
A unique value per request. Replays are rejected.
In: header
Ed25519 signature over the canonical string. See the Signing guide.
In: header
Query Parameters
Narrow to one direction.
Value in
- "in"
- "out"
Asset code, e.g. USDT.
RFC3339. Inclusive lower bound on created_at.
date-timeRFC3339. Inclusive upper bound on created_at.
date-time1-100. Values above 100 are clamped, not rejected.
1 <= value <= 10050The next_cursor from the previous page. Opaque - do not construct
or parse one. A malformed cursor is a 400, never a silent reset to
page one.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/transactions"{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "direction": "in", "status": "successful", "currency": "USDC", "decimals": 6, "amount": "20.000000", "amount_minor": "20000000", "fee": "0.600000", "fee_minor": "600000", "net": "19.400000", "net_minor": "19400000", "created_at": "2019-08-24T14:15:22Z", "reference": "WDR_TBJWZFYIYTM3KPF5", "chain": "ethereum", "network": "onchain", "address": "string", "hash": "string", "invoice": "string", "payment_hash": "string", "address_reference": "string", "address_label": "string", "completed_at": "2019-08-24T14:15:22Z", "failure_code": "transfer_failed", "failure_message": "string", "settlement_currency": "GHS", "settlement_decimals": 0, "settlement_amount": "string", "settlement_amount_minor": "string", "rate": "string", "destination": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "type": "string", "country": "string", "network": "string", "account_masked": "string", "rail": "momo" } } ], "next_cursor": "string"}