Widgets

Widgets are embeddable UI components that you configure once and deploy anywhere. Each widget stores its type, configuration, and theme so you can render consistent payment experiences across multiple pages or apps.

Widget CRUD endpoints require write permission. Listing and retrieving widgets (including stats) require read permission.

Authentication

Authorization: Bearer asp_xxx

Base URL: https://platform-api.anyspend.com/api/v1

Endpoints

List Widgets

GET /widgets

read

List all widget configurations for your account.

cURL
SDK

curl -X GET https://platform-api.anyspend.com/api/v1/widgets \
  -H "Authorization: Bearer asp_xxx"

import { AnySpendClient } from "@b3dotfun/sdk/anyspend";

const client = new AnySpendClient({ apiKey: process.env.ANYSPEND_API_KEY! });
const widgets = await client.widgets.list();

Response

{
  "success": true,
  "data": [
    {
      "id": "wgt_abc123",
      "name": "Homepage Checkout",
      "widget_type": "checkout",
      "description": "Primary checkout widget for the homepage",
      "config": {
        "recipient_address": "0x...",
        "destination_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "destination_chain_id": 8453,
        "amount": "10000000"
      },
      "theme": {
        "primary_color": "#4f46e5",
        "border_radius": 12,
        "font_family": "Inter"
      },
      "views_count": 1240,
      "created_at": "2026-01-10T08:00:00Z",
      "updated_at": "2026-02-20T14:30:00Z"
    }
  ]
}

POST /widgets

write

Create a new widget configuration.

name

string

required

Human-readable name for the widget.

The type of widget to create. One of: swap, checkout, nft, deposit.

config

object

required

Widget-specific configuration object. Contents vary by widget_type (see Widget Types below).

description

string

Optional description for internal reference.

theme

object

Visual theme overrides. See Theme Object below.

cURL
SDK

curl -X POST https://platform-api.anyspend.com/api/v1/widgets \
  -H "Authorization: Bearer asp_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Checkout",
    "widget_type": "checkout",
    "description": "Checkout widget for the product page",
    "config": {
      "recipient_address": "0x1234567890abcdef1234567890abcdef12345678",
      "destination_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "destination_chain_id": 8453,
      "amount": "25000000"
    },
    "theme": {
      "primary_color": "#2563eb",
      "border_radius": 8
    }
  }'

const widget = await client.widgets.create({
  name: "Product Checkout",
  widget_type: "checkout",
  description: "Checkout widget for the product page",
  config: {
    recipient_address: "0x1234567890abcdef1234567890abcdef12345678",
    destination_token: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    destination_chain_id: 8453,
    amount: "25000000",
  },
  theme: {
    primary_color: "#2563eb",
    border_radius: 8,
  },
});

Response

{
  "success": true,
  "data": {
    "id": "wgt_def456",
    "name": "Product Checkout",
    "widget_type": "checkout",
    "description": "Checkout widget for the product page",
    "config": {
      "recipient_address": "0x1234567890abcdef1234567890abcdef12345678",
      "destination_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "destination_chain_id": 8453,
      "amount": "25000000"
    },
    "theme": {
      "primary_color": "#2563eb",
      "border_radius": 8
    },
    "views_count": 0,
    "created_at": "2026-02-27T12:00:00Z",
    "updated_at": "2026-02-27T12:00:00Z"
  }
}

GET /widgets/:id

read

Retrieve a single widget configuration by ID.

cURL
SDK

curl -X GET https://platform-api.anyspend.com/api/v1/widgets/wgt_def456 \
  -H "Authorization: Bearer asp_xxx"

const widget = await client.widgets.get("wgt_def456");

PATCH /widgets/:id

write

Update an existing widget configuration. All fields are optional — only provided fields are changed.

cURL
SDK

curl -X PATCH https://platform-api.anyspend.com/api/v1/widgets/wgt_def456 \
  -H "Authorization: Bearer asp_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Checkout",
    "config": {
      "recipient_address": "0x1234567890abcdef1234567890abcdef12345678",
      "destination_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "destination_chain_id": 8453,
      "amount": "50000000"
    },
    "theme": {
      "primary_color": "#059669"
    }
  }'

const updated = await client.widgets.update("wgt_def456", {
  name: "Updated Checkout",
  config: {
    recipient_address: "0x1234567890abcdef1234567890abcdef12345678",
    destination_token: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    destination_chain_id: 8453,
    amount: "50000000",
  },
  theme: {
    primary_color: "#059669",
  },
});

DELETE /widgets/:id

write

Permanently delete a widget configuration. Existing embeds using this widget ID will stop rendering.

cURL
SDK

curl -X DELETE https://platform-api.anyspend.com/api/v1/widgets/wgt_def456 \
  -H "Authorization: Bearer asp_xxx"

await client.widgets.delete("wgt_def456");

GET /widgets/:id/stats

read

Retrieve view statistics for a widget. Includes total views and a daily breakdown.

cURL
SDK

curl -X GET https://platform-api.anyspend.com/api/v1/widgets/wgt_def456/stats \
  -H "Authorization: Bearer asp_xxx"

const stats = await client.widgets.stats("wgt_def456");

Response

{
  "success": true,
  "data": {
    "widget_id": "wgt_def456",
    "total_views": 1240,
    "daily": [
      { "date": "2026-02-27", "views": 85 },
      { "date": "2026-02-26", "views": 102 },
      { "date": "2026-02-25", "views": 93 }
    ]
  }
}

Field	Type	Description
`id`	`string`	Unique widget identifier (e.g., `wgt_abc123`)
`name`	`string`	Human-readable widget name
`widget_type`	`string`	Widget type: `swap`, `checkout`, `nft`, or `deposit`
`description`	`string \| null`	Optional description
`config`	`object`	Widget-type-specific configuration
`theme`	`object \| null`	Visual theme overrides
`views_count`	`number`	Total number of widget renders
`created_at`	`string`	ISO 8601 creation timestamp
`updated_at`	`string`	ISO 8601 last update timestamp

checkout
swap
nft
deposit

Payment checkout widget for accepting crypto or fiat payments.

Config Field	Type	Description
`recipient_address`	`string`	Merchant wallet address
`destination_token`	`string`	Token contract address to receive
`destination_chain_id`	`number`	Chain ID for destination token
`amount`	`string`	Payment amount in smallest unit

Token swap widget for converting between tokens.

Config Field	Type	Description
`src_token`	`string`	Source token address
`src_chain_id`	`number`	Source chain ID
`dst_token`	`string`	Destination token address
`dst_chain_id`	`number`	Destination chain ID

NFT minting or purchase widget.

Config Field	Type	Description
`collection_address`	`string`	NFT collection contract
`chain_id`	`number`	Chain ID
`token_id`	`string`	Specific token ID (optional)

Deposit widget for funding wallets or accounts.

Config Field	Type	Description
`recipient_address`	`string`	Deposit destination address
`accepted_tokens`	`string[]`	List of accepted token addresses
`accepted_chains`	`number[]`	List of accepted chain IDs

Theme Object

Field	Type	Default	Description
`primary_color`	`string`	`#4f46e5`	Primary accent color (hex)
`border_radius`	`number`	`12`	Border radius in pixels
`font_family`	`string`	`Inter`	Font family name
`dark_mode`	`boolean`	`false`	Enable dark mode rendering

Getting Started

React

Order API

Platform API

Platform API Reference

x402

Token

Advanced

Authentication

Endpoints

List Widgets

Create Widget

Get Widget

Update Widget

Delete Widget

Get Widget Stats

Widget Object

Widget Types

Theme Object

Getting Started

React

Order API

Platform API

Platform API Reference

x402

Token

Advanced

​Authentication

​Endpoints

​List Widgets

​Create Widget

​Get Widget

​Update Widget

​Delete Widget

​Get Widget Stats

​Widget Object

​Widget Types

​Theme Object

Authentication

Endpoints

List Widgets

Create Widget

Get Widget

Update Widget

Delete Widget

Get Widget Stats

Widget Object

Widget Types

Theme Object