---
title: "Paid: Pay-By-Name Resolution"
method: POST
path: "/api/x402/pay-by-name"
---

# Paid: Pay-By-Name Resolution

`POST /api/x402/pay-by-name`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/x402/pay-by-name`
- Auth: none required

Pay-By-Name Resolution — pay $0.001 USDC to resolve a wallet name (@username, a *.sol name, or a raw base58 address) to a verified on-chain Solana address via the three.ws pay-by-name registry. Returns the resolved address, an on-curve verification flag, and the resolution source.

## Request body

- object
  - `name` string, required: @username, a *.sol name, or a base58 address.

## Response `200`

Pay-By-Name Resolution result JSON

## Other responses

- `400`: Validation error
- `402`: Payment Required (x402)

---

[API](https://skmtc.dev/three/apis/three-ws-api.md) · [All operations](https://skmtc.dev/three/apis/three-ws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/three/apis/three-ws-api/revisions/dbc5e3a81b79?raw)
