RWA Trading

For RWA integration overview, see Integrate RWA Trading.

RWA Dividend Claim

Generates Reality RWA dividend claim transaction data (contract + calldata) for the integrator to sign and broadcast. This endpoint does not submit the transaction on-chain.

Request Path: /bgw-pro/swapx/pro/rwa/claim

Request Method: POST

Request Parameters:

Field Name	Field Type	Required	Description
address	string	Yes	User EVM wallet address
chain	string	Yes	Chain identifier, e.g. `arbitrum`; must be a claim-enabled chain

Request Example:


{
    "address": "0xd8FeBD1C242a282f1b8226d34282942F6F63248b",
    "chain": "arbitrum"
}

Response Description:

Parameter Name	Parameter Type	Required	Description
status	number	Yes	Response code, 0 indicates success
data	object	Yes	-
claims	array	Yes	List of claimable dividend transactions; empty array `[]` when nothing is claimable
claims[].sourceAsset	string	No	Source asset identifier for the dividend
claims[].payoutAsset	string	No	Payout asset identifier
claims[].unclaimed	string	No	Claimable amount
claims[].contract	string	No	Dividend distributor contract address (transaction `to`)
claims[].calldata	string	No	Claim transaction calldata
claims[].value	string	No	Native coin value attached to the call; currently `"0"`

Response Example:


{
    "status": 0,
    "error_code": 0,
    "data": {
        "claims": [
            {
                "sourceAsset": "0xSourceAsset...",
                "payoutAsset": "0xPayoutAsset...",
                "unclaimed": "12.345678901234567",
                "contract": "0xDistributor...",
                "calldata": "0x...",
                "value": "0"
            }
        ]
    },
    "msg": "success"
}

Notes:

Only claim-enabled chains are supported; unsupported chains return 80013.
The endpoint only returns unsigned transaction data; signing and broadcasting are done by the integrator.
Generation failures return 80025; see Error Codes for other codes.