--- agentTools: projectIndex: https://docs.quidax.io/llms.txt --- # List an Auto Swap's transactions Return the crypto purchase transactions created from deposits into an Auto Swap's static bank account. Each transaction includes its status, converted amount, deposit details, and crypto payout details when available. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Ramp Merchant API", "version": "3.0" }, "servers": [ { "url": "https://ramp-be.quidax.io/api/v1/merchants/" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "x-private-key", "in": "header", "x-default": "secret_key" } } }, "security": [ { "sec0": [] } ], "paths": { "/custodial/auto_swap/{merchant_reference}/transactions": { "get": { "summary": "List an Auto Swap's transactions", "description": "Return the crypto purchase transactions created from deposits into an Auto Swap's static bank account. Each transaction includes its status, converted amount, deposit details, and crypto payout details when available.", "operationId": "list-an-auto-swaps-transactions", "parameters": [ { "name": "merchant_reference", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "from_currency", "in": "query", "schema": { "type": "string", "enum": [ "ngn" ], "default": "ngn" } }, { "name": "to_currency", "in": "query", "schema": { "type": "string", "enum": [ "usdt", "usdc", "cngn", "usat", "axcngn", "xaust" ], "default": "usdt" } }, { "name": "page", "in": "query", "schema": { "type": "string", "default": "1" } }, { "name": "per_page", "in": "query", "schema": { "type": "string", "default": "25" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"status\": \"ok\",\n \"message\": \"Auto swap transactions fetched successfully\",\n \"data\": [\n {\n \"public_id\": \"761a489c-79e3-48ab-b94e-29b5a69ba950\",\n \"status\": \"completed\",\n \"mode\": \"buy\",\n \"from_currency\": \"ngn\",\n \"to_currency\": \"usdt\",\n \"from_amount\": \"100000.0\",\n \"to_amount\": \"61.75\",\n \"network\": \"erc20\",\n \"merchant_reference\": \"AUTO_SWAP_2b626e77-2185-4b9a-85b7-d762758956a3\",\n \"error_message\": null,\n \"blockchain_fee\": \"0.75\",\n \"crypto_payout\": {\n \"public_id\": \"da715b49-203b-40b7-8d7b-2ddaa9a849db\",\n \"transaction_hash\": \"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"status\": \"completed\",\n \"amount\": \"61.75\",\n \"processor_fee\": \"0.75\",\n \"address\": \"0x1111111111111111111111111111111111111111\",\n \"network\": \"erc20\",\n \"currency\": \"usdt\",\n \"created_at\": \"2026-10-18T09:00:15.000Z\",\n \"updated_at\": \"2026-10-18T09:02:00.000Z\"\n },\n \"fiat_deposit\": {\n \"public_id\": \"59e4b578-a26b-44b9-9753-8e09f086c5f1\",\n \"status\": \"success\",\n \"currency\": \"ngn\",\n \"amount\": \"100000.0\",\n \"fee\": \"100.0\",\n \"created_at\": \"2026-10-18T09:00:00.000Z\",\n \"updated_at\": \"2026-10-18T09:00:00.000Z\"\n },\n \"mobile_money_deposit\": null,\n \"auto_swap\": {\n \"public_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"merchant_reference\": \"customer-1042-auto-swap\",\n \"customer\": {\n \"email\": \"customer@example.com\",\n \"first_name\": \"Ada\",\n \"last_name\": \"Okafor\"\n },\n \"side\": \"onramp\",\n \"deposit_bank_account\": {\n \"account_number\": \"0123456789\",\n \"account_name\": \"Ada Okafor\",\n \"currency\": \"ngn\",\n \"bank_name\": \"Example Bank\",\n \"bank_code\": \"000\"\n }\n },\n \"created_at\": \"2026-10-18T09:00:00.000Z\",\n \"updated_at\": \"2026-10-18T09:02:00.000Z\"\n }\n ],\n \"meta\": {\n \"page\": 1,\n \"per_page\": 25,\n \"total_count\": 1,\n \"total_pages\": 1,\n \"next_page\": null\n }\n}" } }, "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "ok" }, "message": { "type": "string", "example": "Auto swap transactions fetched successfully" }, "data": { "type": "array", "items": { "type": "object", "properties": { "public_id": { "type": "string", "example": "761a489c-79e3-48ab-b94e-29b5a69ba950" }, "status": { "type": "string", "example": "completed" }, "mode": { "type": "string", "example": "buy" }, "from_currency": { "type": "string", "example": "ngn" }, "to_currency": { "type": "string", "example": "usdt" }, "from_amount": { "type": "string", "example": "100000.0" }, "to_amount": { "type": "string", "example": "61.75" }, "network": { "type": "string", "example": "erc20" }, "merchant_reference": { "type": "string", "example": "AUTO_SWAP_2b626e77-2185-4b9a-85b7-d762758956a3" }, "error_message": {}, "blockchain_fee": { "type": "string", "example": "0.75" }, "crypto_payout": { "type": "object", "properties": { "public_id": { "type": "string", "example": "da715b49-203b-40b7-8d7b-2ddaa9a849db" }, "transaction_hash": { "type": "string", "example": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" }, "status": { "type": "string", "example": "completed" }, "amount": { "type": "string", "example": "61.75" }, "processor_fee": { "type": "string", "example": "0.75" }, "address": { "type": "string", "example": "0x1111111111111111111111111111111111111111" }, "network": { "type": "string", "example": "erc20" }, "currency": { "type": "string", "example": "usdt" }, "created_at": { "type": "string", "example": "2026-10-18T09:00:15.000Z" }, "updated_at": { "type": "string", "example": "2026-10-18T09:02:00.000Z" } } }, "fiat_deposit": { "type": "object", "properties": { "public_id": { "type": "string", "example": "59e4b578-a26b-44b9-9753-8e09f086c5f1" }, "status": { "type": "string", "example": "success" }, "currency": { "type": "string", "example": "ngn" }, "amount": { "type": "string", "example": "100000.0" }, "fee": { "type": "string", "example": "100.0" }, "created_at": { "type": "string", "example": "2026-10-18T09:00:00.000Z" }, "updated_at": { "type": "string", "example": "2026-10-18T09:00:00.000Z" } } }, "mobile_money_deposit": {}, "auto_swap": { "type": "object", "properties": { "public_id": { "type": "string", "example": "550e8400-e29b-41d4-a716-446655440000" }, "merchant_reference": { "type": "string", "example": "customer-1042-auto-swap" }, "customer": { "type": "object", "properties": { "email": { "type": "string", "example": "customer@example.com" }, "first_name": { "type": "string", "example": "Ada" }, "last_name": { "type": "string", "example": "Okafor" } } }, "side": { "type": "string", "example": "onramp" }, "deposit_bank_account": { "type": "object", "properties": { "account_number": { "type": "string", "example": "0123456789" }, "account_name": { "type": "string", "example": "Ada Okafor" }, "currency": { "type": "string", "example": "ngn" }, "bank_name": { "type": "string", "example": "Example Bank" }, "bank_code": { "type": "string", "example": "000" } } } } }, "created_at": { "type": "string", "example": "2026-10-18T09:00:00.000Z" }, "updated_at": { "type": "string", "example": "2026-10-18T09:02:00.000Z" } } } }, "meta": { "type": "object", "properties": { "page": { "type": "integer", "example": 1, "default": 0 }, "per_page": { "type": "integer", "example": 25, "default": 0 }, "total_count": { "type": "integer", "example": 1, "default": 0 }, "total_pages": { "type": "integer", "example": 1, "default": 0 }, "next_page": {} } } } } } } }, "404": { "description": "404", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"status\": \"not_found\",\n \"message\": \"Auto swap not found\",\n \"data\": null\n}" } }, "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "not_found" }, "message": { "type": "string", "example": "Auto swap not found" }, "data": {} } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true, "_id": "6981ba5faf9470ee082aeecd:6ad52d1f3ce0fb9e0c742112" } ```