Get funding details

Your USDC deposit addresses, and where your withdrawals go.

GET /api/partner/v1/funding

cURL

curl https://catchbackcards.com/api/partner/v1/funding \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "deposit": {
    "currency": "USDC",
    "credited_to": "balance",
    "addresses": [
      { "chain_type": "ethereum", "address": "0x5f2c…9a1e" },
      { "chain_type": "solana", "address": "7Hq3…Lm2P" }
    ]
  },
  "withdrawal": {
    "network": "USDC on Base",
    "address": "0xab12…ab12",
    "min_amount": 10,
    "daily_limit": 50000,
    "fee": 0
  }
}

Scope: read:account · REST only, no MCP tool

The addresses are yours permanently and never change. A deposit to one lands in your balance once it settles. See Funding in USDC.

Response

deposit · object

Show deposit

currency · string

USDC.

credited_to · string

balance: a deposit adds to your CatchCoins balance.

addresses · object[]

One per kind of chain, each { chain_type, address }. ethereum takes USDC on the EVM chains we accept, Base included; solana takes Solana USDC.

withdrawal · object | null

Where withdrawals go. null until we’ve set your withdrawal address.

Show withdrawal

network · string

USDC on Base.

address · string

Your escrow address.

min_amount · number

The smallest withdrawal, in USD.

daily_limit · number

Withdrawals past this over 24 hours are held for review.

fee · number

0.

Errors

Status	When
403	The key lacks read:account or isn’t linked to an account
502	We couldn’t load the addresses just now. Retry shortly
503	USDC funding is switched off

cURL

curl https://catchbackcards.com/api/partner/v1/funding \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "deposit": {
    "currency": "USDC",
    "credited_to": "balance",
    "addresses": [
      { "chain_type": "ethereum", "address": "0x5f2c…9a1e" },
      { "chain_type": "solana", "address": "7Hq3…Lm2P" }
    ]
  },
  "withdrawal": {
    "network": "USDC on Base",
    "address": "0xab12…ab12",
    "min_amount": 10,
    "daily_limit": 50000,
    "fee": 0
  }
}