Get Bags Payout Feed

The feed of Bags payout payments across all tokens.

An event is one completed end-to-end send: a Peer fill the buyer paid and that was released with verified cash. Claims, bridges, listed or open orders, and pending or pruned fills never appear, and one payout can hold several events, one per buyer. Only X Money payments are returned unless method says otherwise.

With sort=time (default), events are ordered newest first; page backwards by passing the last event’s timestamp as before. With sort=amount, events are ordered by cash paid (USD) descending; page by passing the response’s nextCursor back as cursor. hasMore reports whether more events exist.

GET /bags-payout/feed

Get Bags payout feed

cURL

curl --request GET \
  --url https://public-api-v2.bags.fm/api/v1/bags-payout/feed \
  --header 'x-api-key: <api-key>'

200

{
  "success": true,
  "response": {
    "events": [
      {
        "paymentId": "0x8f3c2b7e1d4a5f6e9c0b1a2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f",
        "payoutId": "6720f1c2a9b3e45d7f8a1b2c",
        "tokenMint": "CyXBDcVQuHyEDbG661Jf3iHqxyd9wNHhE2SiQdNrBAGS",
        "cashoutMethod": "venmo",
        "username": "rebeccaperrotto",
        "displayHandle": "@rebeccaperrotto",
        "amountUsd": 786.04,
        "fiatPaidCents": "78604",
        "usdcAmount": "45746116",
        "usdcDecimals": 6,
        "discountBps": 1000,
        "timestamp": 1794040000,
        "isFirstPayment": true,
        "token": {
          "name": "Rebecca",
          "symbol": "BECCA",
          "image": "https://example.com/token.png"
        }
      }
    ],
    "hasMore": true,
    "nextCursor": "<string>"
  }
}

Authorizations

x-api-key · string · header · required

API key authentication. Provide your API key as the header value.

Query Parameters

limit · integer · default: 100

Maximum number of events to return (1 to 100, default 100)

Required range: 1 <= x <= 100

sort · enum<string> · default: time

Sort order: time orders by payment time, newest first (default); amount by cash paid in USD, largest first

Available options: time, amount

before · integer

Unix timestamp in seconds. Returns only events older than this, for paging with sort=time. Rejected with 400 when sort=amount

Required range: x >= 1

cursor · string

Opaque page cursor for sort=amount, taken from the previous response's nextCursor. Rejected with 400 when sort=time, or when it is not a well-formed cursor

Maximum string length: 4096

minAmountCents · integer

Lower bound (inclusive) on the cash paid, in USD cents

Required range: x >= 1

maxAmountCents · integer

Upper bound (inclusive) on the cash paid, in USD cents. Must be at least minAmountCents

Required range: x >= 1

onlyFirstPayments · enum<string> · default: false

Return only each handle's first payment per token

Available options: true, false

method · enum<string> · default: xmoney

Payout method: xmoney (default), cashapp, venmo or all Payout method to return events for: xmoney (default), cashapp, venmo, or all for every method.

Available options: xmoney, cashapp, venmo, all

Response

200

application/json

Successfully retrieved the payout feed

success · boolean · required

Example:

true

response · object

Show child attributes