---
title: "Submit chain request"
method: POST
path: "/chains/requests"
tags: ["Submissions"]
---

# Submit chain request

`POST /chains/requests`

Public endpoint to request listing a new chain. Rate-limited to 5 submissions per IP per day. Optional X-Api-Key with an admin or agent management token skips the per-IP limit. Submitted RPC URLs are screened; at least one must qualify.

## Request body

- ChainRequestCreate
  - `name` string, required
  - `chain_id` string, required — Decimal or 0x-prefixed chain ID (e.g. "137").
  - `short_name` string, required
  - `native_currency_name` string, required
  - `native_currency_decimals` integer
  - `info_url` string, uri, required
  - `icon_url` string, uri, nullable
  - `rpc_urls` string[], required — HTTPS RPC URLs to screen (max 5). At least one must pass screening.
  - `explorer_urls` string[]
  - `requestor_email` string, email, required
  - `requestor_name` string, required

## Response `201`

Chain request created

- SubmissionCreatedResponse
  - `id` integer, required — Created request ID.

## Other responses

- `400` — Validation or screening failure
- `401` — Unauthorized (invalid X-Api-Key when provided)
- `409` — Chain already exists or pending request exists for this chain ID
- `429` — Per-IP daily submission limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/routemesh/apis/routemesh-api.md) · [All operations](https://skmtc.net/routemesh/apis/routemesh-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routemesh/routemesh-api/versions/6590c9d7229d/schema)