---
title: "Register a direct (1-hop) referral"
method: POST
path: "/economics/api/referral"
tags: ["Mesh Economics"]
---

# Register a direct (1-hop) referral

`POST /economics/api/referral`

Self-referrals are blocked at registration (same wallet, same owner cluster, or same api_key_hash). Only direct referrals — no MLM.

## Request body

- object
  - `referrer_wallet` string, required
  - `referee_wallet` string, required
  - `referrer_agent_id` string
  - `referee_agent_id` string

## Response `200`

Registration result (ok:true if accepted, ok:false if self-referral/duplicate)

---

[API](https://skmtc.net/tooloracle/apis/tooloracle-mcp-platform.md) · [All operations](https://skmtc.net/tooloracle/apis/tooloracle-mcp-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tooloracle/tooloracle-mcp-platform/revisions/58e4e92ec5fa/schema)