> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Nest Check Withdrawal

Check the status of a pending Nest vault withdrawal request on the AtomicQueue. Reads getUserAtomicRequest and checks if offerAmount == 0 (fulfilled) or still pending. Ideal for: withdrawal status polling, rebalancing retry loops, position monitoring.

![Nest Check Withdrawal logo](https://cdn.b3.fun/b3os-icons/plume.svg)
Catalog action Blockchain Data

Check the status of a pending Nest vault withdrawal request on the AtomicQueue. Reads getUserAtomicRequest and checks if offerAmount == 0 (fulfilled) or still pending. Ideal for: withdrawal status polling, rebalancing retry loops, position monitoring.


## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `nest-check-withdrawal` |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | `defi`, `plume`, `nest`, `withdraw`, `check`, `status`, `read`, `rebalancing`, `atomic-queue` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `walletAddress` | `string` | Yes | Wallet address to check withdrawal status for. |
| `tokenAddress` | `string` | Yes | nToken address \(offer token\) that was submitted for withdrawal. |
| `vault` | `string` | No | Vault symbol for context/logging \(e.g., 'nTBILL'\). |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `fulfilled` | `boolean` | Yes | Whether the withdrawal has been fulfilled \(offerAmount == 0 means solver processed it\). |
| `vault` | `string` | Yes | Vault symbol. |
| `tokenAddress` | `string` | No | nToken address checked. |
| `currentRequest` | `object` | No | Current state of the AtomicRequest on-chain. |
| `expired` | `boolean` | No | Whether the request deadline has passed without fulfillment. |

## Examples

**Workflow node**

```json
{
  "type": "nest-check-withdrawal",
  "payload": {
    "tokenAddress": "0x0000000000000000000000000000000000000000",
    "walletAddress": "0x0000000000000000000000000000000000000000"
  },
  "children": []
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/nest-check-withdrawal/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "tokenAddress": "0x0000000000000000000000000000000000000000",
    "walletAddress": "0x0000000000000000000000000000000000000000"
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.