nirholas/x402-payments
skills/x402-payments/SKILL.md
Enable and integrate x402 crypto payment protocol for XActions API access. Supports multi-chain, multi-token payments for pay-per-use API calls. Use when users want to pay for XActions operations with crypto or integrate x402 into their own agent/app.
$ install --global
skillsauthnpx skillsauth add nirholas/xactions x402-paymentsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 2:12 AM23.6s1 file scanned
SKILL.md
- name:
- x402-payments
- description:
- Enable and integrate x402 crypto payment protocol for XActions API access. Supports multi-chain, multi-token payments for pay-per-use API calls. Use when users want to pay for XActions operations with crypto or integrate x402 into their own agent/app.
- license:
- MIT
- author:
- nichxbt
- version:
- 1.0
x402 Payments
XActions supports the x402 payment protocol — an HTTP-native micropayment standard for pay-per-use API access with cryptocurrency.
Entry Points
| Goal | Route | Method |
|------|-------|--------|
| Discover payment capabilities | GET /.well-known/x402 | Public |
| Get OpenAPI spec with payment info | GET /api/x402/openapi | Public |
| Make a paid API call | Any protected route | REST API (with x402 headers) |
Configuration
Config lives in api/config/x402-config.js. Key settings:
{
networks: ['base', 'ethereum', 'polygon', 'arbitrum'], // Supported chains
tokens: {
base: ['USDC', 'ETH'],
ethereum: ['USDC', 'USDT', 'ETH'],
polygon: ['USDC', 'MATIC'],
arbitrum: ['USDC', 'ETH'],
},
pricing: {
'POST /api/operations/unfollow': { amount: '0.01', token: 'USDC' },
'POST /api/operations/follow': { amount: '0.005', token: 'USDC' },
// ... per-route pricing
}
}
Discovery (/.well-known/x402)
Returns a JSON manifest describing all payable routes, supported networks, and token addresses:
GET https://api.xactions.io/.well-known/x402
Response includes:
- List of payable API endpoints with prices
- Supported blockchain networks
- Token contract addresses per network
- Payment verification endpoint
Making a Paid Request
x402-compatible clients handle payment automatically. For manual integration:
# 1. Get payment requirements (HTTP 402 response)
POST /api/operations/unfollow → 402 Payment Required
X-Payment-Required: { amount, token, network, recipient }
# 2. Submit on-chain payment + proof
POST /api/operations/unfollow
X-Payment: <signed-payment-proof>
Middleware
api/middleware/x402.js handles:
- Detecting x402-protected routes
- Returning
402 Payment Requiredwith payment details - Verifying payment proofs before processing requests
- Multi-chain verification across Base, Ethereum, Polygon, Arbitrum
Supported Clients
Any x402-compatible client works automatically:
x402-axios— Axios adapter with auto-paymentx402-fetch— Fetch adapter with auto-payment- Claude agents with x402 MCP tools
- Custom implementations following the x402 spec
Notes
- x402 payments are per-request — no subscription needed
- Payment proofs are cryptographically verified on-chain before operations run
- Use
/.well-known/x402for discovery in agent applications - Stripe billing (
billing-managementskill) remains an alternative for subscription access
Related Skills
- billing-management — Stripe subscription-based payment alternative
- xactions-mcp-server — MCP server that uses x402 for AI agent access
- a2a-multi-agent — Agent-to-agent workflows that use x402 for payment
Related Skills
nirholas/xactions-mcp-server
tools
VerifiedTrustedCommunity
Free MCP server providing 68+ tools for AI agents to automate X/Twitter. Scrapes profiles, followers, tweets. Posts, follows, likes, retweets, downloads videos, analyzes sentiment, monitors brands, manages DMs, runs workflows, and more. Uses local Puppeteer -- no API keys or payments required. Compatible with Claude Desktop, Cursor, Windsurf, VS Code. Use when setting up or using AI agent Twitter automation via MCP.
192SKILL.mdUpdated Apr 10, 2026
nirholas/xactions-cli
tools
VerifiedTrustedCommunity
Command-line interface for scraping X/Twitter data, managing MCP server config, and running automation. Scrapes profiles, followers, tweets, search results, and more from terminal. Outputs text, JSON, or CSV. Uses Puppeteer stealth. Use when running Twitter operations from command line or automated pipelines.
192SKILL.mdUpdated Apr 10, 2026
nirholas/x-pro-management
tools
VerifiedTrustedCommunity
Navigate to X Pro (TweetDeck), set up monitoring columns, and manage multi-column view. Use when users want to use X Pro / TweetDeck features or set up a multi-column dashboard.
192SKILL.mdUpdated Apr 10, 2026
nirholas/webhooks
tools
VerifiedTrustedCommunity
Create, manage, and test webhooks in XActions. Get notified via HTTP when automation jobs complete, followers change, or operations finish. Use when users want to integrate XActions events into external systems.
192SKILL.mdUpdated Apr 10, 2026