> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/assets-withdraw-settle-pnl/get-receiver-events.md).

# Get Receiver Events

## Get Receiver Events

Returns transfer events detected at the account's exclusive receiver address. Poll this endpoint to check deposit status after tokens are transferred to that address.

### Endpoint

**GET /v1/client/asset/receiver\_events**

Mainnet: GET <https://api.orderly.org/v1/client/asset/receiver\\_events\\>
Testnet: GET <https://testnet-api.orderly.org/v1/client/asset/receiver\\_events>

Rate limit: 10 requests per second.

### Headers

* `orderly-timestamp` (string, required): Signed request timestamp in milliseconds.
* `orderly-account-id` (string, required): Authenticated account ID.
* `orderly-key` (string, required): Public key used to sign the request.
* `orderly-signature` (string, required): Signature of the request payload.

### Parameters

No query or path parameters.

### Response

HTTP 200 returns `success` (boolean), `timestamp` (server time in milliseconds), and `data.rows`, an array of detected transfer events. Each row contains `chain_id` (string), `tx_id` (transaction hash), `token` (token symbol), `amount` (number), `created_time` (detection time in UNIX milliseconds), and `updated_time` (last status update in UNIX milliseconds).

```
{"success":true,"timestamp":1702989203989,"data":{"rows":[{"chain_id":"42161","tx_id":"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef","token":"USDC","amount":29.619521,"created_time":1767848705855,"updated_time":1767848724143}]}}
```
