API Preview - This API is under active development. Endpoints may change without notice.

REST API/Marketplace

Marketplace

x402 transaction records and identity income tracking.

4 endpoints

Endpoints

Method	Path	Description	Auth
GET	`/marketplace/my-earnings` Get member earnings	Get member earnings	JWT
GET	`/marketplace/my-purchases` Get organisation purchases	Get organisation purchases	JWT
POST	`/marketplace/transactions` Create x402 transaction	Create x402 transaction	JWT
GET	`/marketplace/transactions/{transaction_id}` Get transaction details	Get transaction details	JWT

Endpoint Details

POST/marketplace/transactionsJWT

Record a mock identity data marketplace transaction. In production, this triggers a real x402 payment flow. The authenticated user must be a party (member or organisation).

Request Example

json

{
  "member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "org_id": "e1f2a3b4-c5d6-7890-efab-cdef12345678",
  "data_type": "trait_profile",
  "price_aud": 5
}

Response

json

{
  "id": "f1e2d3c4-b5a6-9870-fedc-ba0987654321",
  "member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "org_id": "e1f2a3b4-c5d6-7890-efab-cdef12345678",
  "data_type": "trait_profile",
  "price_aud": 5,
  "status": "completed",
  "protocol_version": "x402-v1",
  "created_at": "2026-03-10T10:00:00Z"
}

GET/marketplace/my-earningsJWT

Returns total earnings and transaction history for the authenticated member.

GET/marketplace/my-purchasesJWT

Returns total spend and transaction history for the authenticated organisation.

GET/marketplace/transactions/{transaction_id}JWT

Retrieve a single x402 transaction by ID. The user must be a party in the transaction.

Path Parameters

Name	Type	Required	Description
`transaction_id`*	`string`	Required	Transaction UUID

Marketplace

Endpoints

Endpoint Details

POST /marketplace/transactions

Request Example

Response

GET /marketplace/my-earnings

GET /marketplace/my-purchases

GET /marketplace/transactions/{transaction_id}

Path Parameters