Introduction

Create and manage Moove Payment Links programmatically.

The API is live and serving production traffic. Base URL https://api.moove.xyz.

Quickstart

Create an API key

At moove.xyz/dashboard/api-keys, scoped to the Moove Receive Agent. The plaintext key is shown once.Moove API Keys →

Create a payment link

curl -sS -X POST "https://api.moove.xyz/v1/payment-link" \
  -H "X-API-Key: $MOOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "toAmount": "49.99", "description": "INV-2026-0142", "maxUsage": 1 }'

Response

{
  "id": "0c8f2e5a-4b91-4c3e-9d17-2f6a8b0d1e34",
  "url": "https://www.moove.xyz/@yourhandle/pay/0c8f2e5a-4b91-4c3e-9d17-2f6a8b0d1e34"
}

Send the payer to `url`

They pay in any token on any chain. It settles to your default wallet in your settlement token.

At a glance

Property	Value
Base URL	`https://api.moove.xyz`
Schema	`https://api.moove.xyz/openapi.json` — OpenAPI 3.1.0
Rendered schema	`https://api.moove.xyz/docs`
Authentication	`X-API-Key` header
Format	JSON request and response bodies
Versioning	Path-based — `/v1/…`

Endpoints

Method	Path	Scope	Description
`POST`	`/v1/payment-link`	`payment_link:create`	Create a payment link
`GET`	`/v1/payment-link`	`payment_link:read`	List payment links
`GET`	`/v1/payment-link/{id}`	— public	Retrieve a payment link

Before your first call

The API refuses to create links for an account that cannot receive payments. Make sure the key owner has:

Claimed a Moove Handle.
Set a default wallet with a settlement token.

Without both, POST /v1/payment-link returns 409.

What the API cannot do

No endpoint moves funds. A payment link always settles to the authenticated user’s own default wallet, in that wallet’s chain and token. The caller cannot specify a destination.A key is a down-scope of its owner: it acts as that user and can only do a subset of what they can do. A leaked key can request payments that pay its owner — it cannot redirect money elsewhere.

There is also no key-minting endpoint. Key management is session-authenticated only, so a key can never issue another key.

Coming soon

Moove Send, Moove Swap, Moove Bridge, Moove Stake and Moove Ramp have no public API yet. The pages under Coming Soon track what is planned.

Authentication

Keys, scopes and the header.

Moove Payment Links

Both endpoints in full.

Errors

Status codes and retry behaviour.

API Documentation

Moove Receive

Coming Soon

Quickstart

At a glance

Endpoints

Before your first call

What the API cannot do

Coming soon

Next

Authentication

Moove Payment Links

Errors

​Quickstart

​At a glance

​Endpoints

​Before your first call

​What the API cannot do

​Coming soon

​Next

Authentication

Moove Payment Links

Errors

Quickstart

At a glance

Endpoints

Before your first call

What the API cannot do

Coming soon

Next