List Swaps

GET /swaps

Retrieves a paginated list of the most recent Swap requests.

• Request headers required. See Request Headers for more information.

• Authentication required. See Authentication Headers for more information.

Required Permissions

Name	Conditions
Swaps:Read	Always Required

Parameters

Query parameters

Query string parameter	Required/Optional	Description	Type
limit	Optional	Maximum number of items to return. Default to 50.	Number
paginationToken	Optional	Opaque token used to retrieve the next page. Returned as nextPageToken from the previous request.	String

Response

200 Response example

{
    "items": [
        {
            "id": "swap-6a3ku-bn8d7-8u5rs1oukojms7k8",
            "quoteId": "swapQuote-3hgv4-q8tbf-8v2ajmrbmg6m4i9t",
            "reference": null,
            "sourceWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
            "targetWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
            "status": "PendingPolicyApproval",
            "provider": "UniswapClassic",
            "quotedSourceAsset": {
                "kind": "Native",
                "amount": "10000000000",
                "metadata": {
                    "network": "EthereumSepolia",
                    "name": "Ethereum",
                    "symbol": "SepoliaETH",
                    "decimals": 18,
                    "tid": "native:eth"
                }
            },
            "quotedTargetAsset": {
                "kind": "Erc20",
                "contract": "0xda0be7efd234295395d4204d0df4358339b57b27",
                "amount": "6467571553831928182",
                "metadata": {
                    "network": "EthereumSepolia",
                    "name": "Test",
                    "symbol": "Test",
                    "decimals": 18,
                    "tid": "erc20:0xda0be7efd234295395d4204d0df4358339b57b27"
                }
            },
            "slippageToleranceInBps": 100,
            "dateCreated": "2025-09-11T10:57:55.758Z",
            "requestBody": {
                "sourceWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
                "quoteId": "swapQuote-3hgv4-q8tbf-8v2ajmrbmg6m4i9t"
            },
            "requester": {
                "userId": "us-48r5q-eshfg-9pmr2lo6bmpr4i4i",
                "tokenId": "to-4etah-smoal-9n3rmhul4dpaueg5"
            }
        }
    ]
}