NEAR deposits

These endpoints wrap the NEAR Intents 1Click API. The recipient is always the caller’s own Numpay wallet, looked up on the server. See Deposit flows for the full sequence. Get a deposit quote, submit the NEAR transfer and check deposit status.

Get a deposit quote

POST /near/deposit-quote · Requires auth

string

required

Decimal USDC with up to 6 decimals, between "1" and "10000".

string

required

The NEAR account sending the USDC, for example alice.near. Refunds go here.

Response 200

{
  "depositAddress": "a1b2c3…",
  "depositMemo": null,
  "amountIn": "12500000",
  "amountInFormatted": "12.5",
  "amountOutFormatted": "12.47",
  "timeEstimate": 60,
  "deadline": "2026-11-05T10:42:00.000Z",
  "recipient": "0x8bA1…BA72"
}

Send exactly amountIn base units of NEAR USDC to depositAddress with ft_transfer, before deadline. Errors: 400 bad amount or NEAR account, or 1Click rejected the quote · 404 caller has no Numpay wallet · 502 1Click unavailable · 503 NEAR deposits not configured.

Submit the deposit transaction

POST /near/deposit-submit · Requires auth Tells 1Click about the NEAR transfer so it doesn’t have to wait to notice it.

string

required

NEAR transaction hash (base58, 43–44 characters).

string

required

From the quote.

string

required

The sending NEAR account.

Response 200

{ "success": true }

Get deposit status

GET /near/deposit-status/{depositAddress} · Requires auth Returns 404 unless the deposit was quoted for the caller’s wallet. When the status first reaches SUCCESS, the deposit is recorded in the caller’s history as a DEPOSIT transaction (once per Base transaction hash).

Response 200

{
  "status": "SUCCESS",
  "updatedAt": "2026-11-05T10:13:09.000Z",
  "amountOutFormatted": "12.47",
  "baseTxHash": "0x5e0d…71c3"
}

`status`	Meaning	Final
`PENDING_DEPOSIT`	Waiting for the NEAR transfer
`KNOWN_DEPOSIT_TX`	Transfer reported, not yet processed
`PROCESSING`	Moving USDC to Base
`SUCCESS`	Delivered on Base	Yes
`INCOMPLETE_DEPOSIT`	Less arrived than quoted; will be refunded	Yes
`REFUNDED`	Returned to the NEAR account; see `refundReason`	Yes
`FAILED`	Failed; any USDC sent is refunded	Yes

The app polls every 4 seconds for up to 15 minutes.

Basics

Endpoints

Get a deposit quote

Submit the deposit transaction

Get deposit status

​Get a deposit quote

​Submit the deposit transaction

​Get deposit status

Get a deposit quote

Submit the deposit transaction

Get deposit status