GET/v2/paymentsAuth required

Get payment history

Returns confirmed payments received across all stores, ordered newest-first.

Requires Bearer token authentication. Include Authorization: Bearer YOUR_API_KEY in the request header.

Query Parameters

limitintegerdefault: 200

Maximum number of payments to return (1–200). Defaults to 200.

timeframestring enumdefault: "1M"

Time window to filter payments. 1W = 1 week, 2W = 2 weeks, 1M = 1 month, 3M = 3 months, 6M = 6 months, 1Y = 1 year.

"1W""2W""1M""3M""6M""1Y"

cryptostring enum

Filter by cryptocurrency. Omit to return all cryptocurrencies.

"BTC""BCH""USDT"

store_namestring

Partial case-insensitive store name filter.

currencystring

Fiat currency code (e.g. USD). When provided, each payment includes a fiat_value field with the historical fiat equivalent.

Responses

dataarray[]View payment object

Monitor USDT Transaction

POST /monitor_tx

limitquery · integer

Maximum number of payments to return (1–200). Defaults to 200.

timeframequery · string

Time window to filter payments. `1W` = 1 week, `2W` = 2 weeks, `1M` = 1 month, `3M` = 3 months, `6M` = 6 months, `1Y` = 1 year.

cryptoquery · string

Filter by cryptocurrency. Omit to return all cryptocurrencies.

store_namequery · string

Partial case-insensitive store name filter.

currencyquery · string

Fiat currency code (e.g. `USD`). When provided, each payment includes a `fiat_value` field with the historical fiat equivalent.

Response will appear here

Request

curl -X GET \
  "https://www.blockonomics.co/api/v2/payments?limit=%7Bvalue%7D&timeframe=1W" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://www.blockonomics.co/api/v2/payments?limit=%7Bvalue%7D&timeframe=1W', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})

const data = await response.json()
console.log(data)

import requests

headers = {
        "Authorization": "Bearer YOUR_API_KEY"
    }

response = requests.get(
    "https://www.blockonomics.co/api/v2/payments?limit=%7Bvalue%7D&timeframe=1W",
    headers=headers
)

print(response.json())

Response

{
  "data": [
    {
      "id": 42,
      "timestamp": 1700000000,
      "crypto": "BTC",
      "amount": 500000,
      "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "txid": "c4978bfc9b4cd632fb37eb5f69c7c686ae364d9cb1b32ec01c0f8bae72530a4e",
      "store_name": "My Shop",
      "store_url": "https://example.com/callback",
      "fiat_value": 18.5
    }
  ]
}