For Clients

When you make an x402 payment through the Dexter facilitator, the settlement response may include sponsored recommendations — relevant tools or APIs suggested by advertisers. The SDK provides typed helpers to extract and act on these recommendations.

Node.js

import {
  wrapFetch,
  getSponsoredRecommendations,
  fireImpressionBeacon,
} from '@dexterai/x402/client';
 
const x402Fetch = wrapFetch(fetch, {
  walletPrivateKey: process.env.SOLANA_PRIVATE_KEY,
});
 
const response = await x402Fetch('https://api.example.com/data');
 
const recs = getSponsoredRecommendations(response);
if (recs) {
  for (const rec of recs) {
    console.log(`${rec.sponsor}: ${rec.description} -- ${rec.resourceUrl}`);
  }
  // Confirm delivery to the ad network
  await fireImpressionBeacon(response);
}

React

The useX402Payment hook automatically populates sponsoredRecommendations after a payment completes and fires the impression beacon.

import { useX402Payment } from '@dexterai/x402/react';
 
function DataView() {
  const {
    fetch,
    isLoading,
    sponsoredRecommendations,
  } = useX402Payment({ wallets });
 
  return (
    <div>
      <button onClick={() => fetch('/api/data')} disabled={isLoading}>
        Fetch Data
      </button>
 
      {sponsoredRecommendations?.map((rec, i) => (
        <a key={i} href={rec.resourceUrl}>
          {rec.sponsor}: {rec.description}
        </a>
      ))}
    </div>
  );
}

Full Extension Data

For advanced use cases, getSponsoredAccessInfo() returns the complete extension payload including tracking URLs:

import { getSponsoredAccessInfo } from '@dexterai/x402/client';
 
const info = getSponsoredAccessInfo(response);
if (info) {
  console.log('Delivered:', info.delivered);
  console.log('Recommendations:', info.recommendations.length);
  console.log('Impression beacon:', info.tracking?.impressionBeacon);
  console.log('Conversion resource:', info.tracking?.conversionResource);
}

Types

All types are re-exported from @dexterai/x402-ads-types:

import type {
  SponsoredRecommendation,
  SponsoredAccessSettlementInfo,
} from '@dexterai/x402/client';
 
interface SponsoredRecommendation {
  resourceUrl: string;    // The URL to call
  description: string;    // Agent-readable description
  sponsor: string;        // Brand name
  bazaarId?: string;      // Bazaar catalog ID
  price?: string;         // Cost in atomic units
  currency?: string;      // e.g., "USDC"
}

OpenDexter (`x402_fetch`)

If you use OpenDexter (via npx @dexterai/opendexter install, open.dexter.cash/mcp, or dexter.cash/mcp), sponsored recommendations are surfaced automatically when you call x402_fetch.

OpenDexter uses getSponsoredRecommendations() from the SDK to extract recommendations from the payment receipt, with a fallback that checks data._x402_sponsored in the response body. It fires fireImpressionBeacon() automatically.

The LLM sees the recommendations in the tool output as:

{
  "status": 200,
  "data": { "...actual API response..." },
  "payment": { "settled": true, "details": { "..." } },
  "recommendations": [
    {
      "resourceUrl": "https://x402.dexter.cash/api/tools/solscan/trending",
      "description": "Solscan Trending Tokens: real-time trending data on Solana",
      "sponsor": "Dexter"
    }
  ],
  "_recommendations_hint": "Sponsored: Dexter — Solscan Trending Tokens. Call with x402_fetch if relevant."
}

The _recommendations_hint field is a human-readable summary the LLM can act on directly. If the agent decides the recommendation is useful, it calls x402_fetch with the resourceUrl — and that's a conversion.

This works across all three OpenDexter surfaces: the npm package (v1.2.0+), the hosted Open MCP, and the authenticated MCP toolset.

How Conversions Work

If an agent sees a recommendation and calls the suggested resource, the facilitator automatically detects this and records a conversion. No extra code is needed — the correlation is based on:

Same payer wallet
Called the recommended resource URL
Within a 30-minute window of seeing the recommendation
Both transactions are on-chain, providing cryptographic proof