---
title: "Look for a top-up now"
method: POST
path: "/api/v1/deposits/check"
tags: ["Deposits"]
---

# Look for a top-up now

`POST /api/v1/deposits/check`

## Request

- Base URL: `https://spoofy.social`
- URL: `https://spoofy.social/api/v1/deposits/check`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Sent something to your deposit address? Ask now instead of waiting for the next pass. With `txHash` (a transaction hash, or a Solana signature) that one transfer is checked; without, your address on that network is looked over for the last couple of hours. Whatever arrived is added to your balance (once, however often you ask), and `status` + `message` say where it stands — `confirming` with `confirmations` while the network confirms it. One check per network every 3 s with a hash, every 20 s without (`check_too_soon`).

## Request body

- object
  - `method` string: A method id, e.g. base-usdc.
  - `network` string: Or just the network, e.g. base.
  - `txHash` string

## Response `200`

Where the top-up stands.

- DepositCheck
  - `status` 'credited' | 'received' | 'confirming' | 'not_found' | 'failed' | 'not_to_you' | 'unsupported_coin' | 'nothing_new': credited: added to the balance · received: arrived, waiting for the network’s minimum · confirming: seen, waiting for `confirmations.need` blocks · not_found: not visible yet · failed: the transaction failed · not_to_you: it paid someone else · unsupported_coin: a coin we do not take there · nothing_new: nothing new arrived lately.
  - `network` object
    - `key` string
    - `name` string
  - `deposits` Deposit[]
    - `id` string
    - `asset` string
    - `amount` string: In the coin, as it arrived.
    - `value` string: Value at deposit time. USD as a decimal string.
    - `credit` string: Added to the balance. USD as a decimal string.
    - `txHash` string: Transaction hash (EVM) or signature (Solana).
    - `status` 'seen' | 'credited': seen = received, waiting for confirmations or the minimum; credited = in the balance.
    - `createdAt` string, date-time
    - `creditedAt` string, date-time, nullable
    - `network` object
      - `key` string
      - `name` string
    - `explorerUrl` string: The transaction on the network’s explorer.
  - `confirmations` object
    - `have` integer
    - `need` integer
  - `message` string: One plain sentence for a person.

## Other responses

- `400`: The request is not valid. `error.message` says why.
- `401`: No valid API key or session.
- `413`: The request body is too big (uploads up to 4 MB, everything else up to 64 KB).
- `429`: Slow down: too many requests in a short time. Wait `Retry-After` seconds and carry on.

---

[API](https://skmtc.dev/spoofy/apis/spoofy-api.md) · [All operations](https://skmtc.dev/spoofy/apis/spoofy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoofy/apis/spoofy-api/revisions/0619b5c8adae?raw)