Deposits

Look for a top-up now

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).

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

Request body

methodstring

A method id, e.g. base-usdc.

networkstring

Or just the network, e.g. base.

txHashstring

Response

Where the top-up stands.

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.

messagestring

One plain sentence for a person.

Changes

No recorded changes to this operation across all 1 revision of this API.