API Documentation for Partner Analytics

Range

The lookback window. Defaults to 7d.

Allowed Values:

• 1d
• 7d
• 30d
• 90d

Network

Required: CAIP-2 network filter, or the alias solana-mainnet / solana-devnet.

Responses

200 - Successful Response

Usage rows for the partner, newest window first.

Data Structure

{
  "data": [
    {
      "merchantOrganizationId": "string",
      "merchantOrganizationName": "string",
      "endpoint": "https://api.merchant.test/widget",
      "count": 42,
      "volumeUsd": "1234.560000"
    }
  ],
  "meta": {
    "range": "7d",
    "network": "solana-mainnet",
    "partnerOrganizationId": "22222222-2222-4222-8222-222222222222"
  }
}

400 - Bad Request

Unsupported range value, or missing/invalid network.

403 - Forbidden

Missing or malformed tenant header (staging/production).

Example Usage

CURL Example

curl --request GET \
     --url https://api.figment.io/x402/partner_analytics \
     --header 'accept: application/json' \
     --header 'x-api-key: your-api-key-here'