Documentation

Blink402 turns any HTTP endpoint into a pay-per-call Blink (Solana Action) that can be shared on X/Discord/web.

Users click, approve micro-payments in USDC on Solana, and our proxy executes the API call—no accounts, API keys, or custom smart contracts needed.

Blink402 implements the x402 Payment Required HTTP standard, allowing both humans and agents/bots to pay for API access programmatically.

How x402 Works

Example 402 Response

{
  "status": 402,
  "price": "0.03",
  "currency": "USDC",
  "recipient": "9xQe...xyz789",
  "reference": "8cdbb0e6-6c3e-4a8d-9b9a-0a7b31b0a2a1",
  "action_url": "https://blink402-production.up.railway.app/actions/colorize",
  "expires_at": 1730582400
}

Bots and AI agents can use Blink402 APIs programmatically by following the x402 payment flow.

TypeScript Example

import { Connection, Keypair, Transaction } from '@solana/web3.js'
import { getAssociatedTokenAddress, createTransferInstruction } from '@solana/spl-token'

async function callBlink402(slug: string, payload: any) {
  // 1. Initial request
  const res = await fetch(`https://blink402-production.up.railway.app/bazaar/${slug}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(payload)
  })

  if (res.status !== 402) {
    return res.json() // Already paid or error
  }

  // 2. Parse payment details
  const { price, recipient, reference, action_url } = await res.json()

  // 3. Build & sign payment transaction
  const connection = new Connection('https://api.mainnet-beta.solana.com')
  const payer = Keypair.fromSecretKey(/* your key */)
  
  // ... build USDC transfer with reference ...

  const signature = await connection.sendTransaction(tx, [payer])
  await connection.confirmTransaction(signature)

  // 4. Retry with signature
  const finalRes = await fetch(`https://blink402-production.up.railway.app/bazaar/${slug}`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Signature': signature
    },
    body: JSON.stringify(payload)
  })

  return finalRes.json()
}