v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
offramp

Check if there is a pending offramp that needs USDC sent to Coinbase

Check if the authenticated user has a pending offramp withdrawal where Coinbase has provided a deposit address (to_address). If so, the frontend should send USDC from the user's Smart Account earnings wallet to that address.

Polling pattern: Frontend polls this every ~5 seconds after the user returns from the Coinbase offramp UI.

If a pending event exists but Coinbase hasn't provided a deposit address yet, this endpoint triggers a background Coinbase scan and returns pending=True with to_address=null. The next poll will pick up the address after the scan.

get/v1/offramp/pending-send

Headers

authorizationstring nullable

Bearer JWT issued by Grove.

Bearer JWT issued by Grove.

Response

Successful Response

pendingboolean required

Whether there is a pending offramp send

event_idstring nullable

Withdrawal event ID

to_addressstring nullable

Coinbase deposit address to send USDC to

amountstring nullable

Amount to send (token units)

networkstring nullable

Network for the send (e.g., base, base-sepolia)

created_atstring nullable

When the event was created (ISO 8601)