API Reference

List settlements for a UDA address

GET /uda/{id}/settlements

List all settlements created for a given UDA address, optionally paginated.

Path parameters

NameTypeDescription
idrequiredstringUDA address id.

Query parameters

NameTypeDescription
limitoptionalintegerdefault: 50Page size (default 50, max 200).
offsetoptionalintegerdefault: 0Number of items to skip (default 0).

Responses

A page of settlements.

    • idstring
    • uda_idstring
    • statusstringenum: created · routing · completed · failed · retrying
    • created_atstringformat: date-time
    • updated_atstringformat: date-time
    • errorstring

      Failure reason when `status` is `failed`; empty otherwise.

    • countinteger

      Number of items in this page.

    • limitinteger
    • offsetinteger
Request
curl "https://api.stridge.dev/v1/uda/string/settlements" \
  -H "X-API-Key: $STRIDGE_API_KEY"

Set your key as STRIDGE_API_KEY (sent as X-API-Key).

Response200
"id": "stl_71829304a5b6c7d8",
"uda_id": "uda_2f8c1a9d4e5f6071",
"status": "completed",
"created_at": "2026-05-29T11:58:41Z",
"updated_at": "2026-05-29T11:59:25Z",
"error": "",
"address": "0x7c2d9a1b3e4f5061728394a5b6c7d8e9f0a1b2c3",
"amount": "1000000",
"asset_symbol": "USDC",
"asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"network_id": 1,
"network_name": "Ethereum",
"tx_hash": "0xab12cd34ef56...7890",
"confirmed_at": "2026-05-29T11:58:40Z"
},
"address": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345",
"amount": "998500",
"asset_symbol": "USDC",
"asset_address": "0x55d398326f99059fF775485246999027B3197955",
"network_id": 56,
"network_name": "BNB Smart Chain",
"tx_hash": "0xcd34ef5678...90ab",
"settled_at": "2026-05-29T11:59:25Z"
},
"total": "1500",
"platform": "1500",
"provider": "0",
"fee_amount": "1500"
},
"provider": "lifi",
"type": "cross_chain_swap",
"time_ms": 45000
}
}
],
"count": 20,
"limit": 50,
"offset": 0
}
}