---
title: "Royalty-Split Config Validator"
method: POST
path: "/v1/tools/validate_royalty_split_config"
tags: ["royalty", "erc-2981", "0xsplits", "basis points", "split", "nft", "tokenization", "ip licensing", "on-chain", "validation", "compliance"]
---

# Royalty-Split Config Validator

`POST /v1/tools/validate_royalty_split_config`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/validate_royalty_split_config`
- Auth: none declared

Validates on-chain royalty split configurations for ERC-2981 (single-receiver) and 0xSplits-style (multi-recipient) protocols. Checks: sum equals 10000 basis points, no per-recipient cap breach, no duplicate or blank addresses, valid Ethereum address format, valid range per entry. Auto-detects bps vs percent mode. Exports an AINumbers Policy Mandate on valid configs.

**Tool URL:** https://ainumbers.co/tools/527-royalty-split-validator.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `entries` object[], required
    - `address` string
    - `basis_points` number
    - `bps` number
    - `shares` number
    - `percent` number
  - `cap_bps` number

## Response `200`

Successful tool execution result

- object
  - `valid` boolean
  - `mode` 'bps' | 'percent'
  - `total_bps` number
  - `recipient_count` integer
  - `errors` string[]
  - `config_fingerprint` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)