Address Verification - Paxos Documentation

Address verification is in Developer Preview. Endpoints and schemas are subject to change. To participate, contact Paxos Support.

Address verification confirms that a user or partner controls a blockchain address. Verified addresses can establish reward claim eligibility and support compliance workflows.

The API represents each verification attempt as a verification record. A verification record is the API resource you create, retrieve, list, and complete. It confirms address control for the requested Paxos use case; it does not determine custody, title, or legal rights.

How Verification Works

Paxos supports two API verification methods and an off-platform manual review path. Choose based on what the address holder can do, then follow the Verify an Address guide.

Method	When to use	How it works
`SIGNATURE`	The address holder can sign a message directly or through a wallet integration	Create a verification record, collect the signed message, then submit the signature via Submit Signature
`SMALL_DEPOSIT`	The address holder can send a transaction from the address but cannot sign a message	Send the exact amount specified in the response from the address under verification to a Paxos-controlled address
`MANUAL`	Additional verification requirements have not yet been automated	Contact Support for requirements. Manual review is handled off-platform and is not created through the public API.

Verification Lifecycle

Status	Meaning	Next step
`PENDING`	In progress	Poll Get Address Verification with the returned `id`. For `SIGNATURE`, submit the collected signature via Submit Signature. For `SMALL_DEPOSIT`, wait for on-chain confirmation or send again from the same address.
`APPROVED`	Address control confirmed	Done
`EXPIRED`	Verification window elapsed	Create a new verification and retry

API-created SIGNATURE and SMALL_DEPOSIT verifications expire after 48 hours. Check expires_at in the response and create a new verification if the window elapses. Manual review is handled off-platform and does not expire through the public API.

Supported Networks

All networks support both SIGNATURE and SMALL_DEPOSIT. The signing standard only applies when using SIGNATURE.

Network	Signing standard (SIGNATURE)
`ARBITRUM_ONE`	EIP-191 (`personal_sign`)
`ETHEREUM`	EIP-191 (`personal_sign`)
`INK`	EIP-191 (`personal_sign`)
`ROBINHOOD`	EIP-191 (`personal_sign`)
`SOLANA`	ed25519
`XLAYER`	EIP-191 (`personal_sign`)

Required OAuth Scopes

Scope	Access
`address_ownership:read_verification`	Read and list verifications
`address_ownership:write_verification`	Create and complete verifications

API Reference

Endpoint	Description
Create Address Verification	Initiate a new verification
Submit Signature	Submit a signature to complete a `SIGNATURE` verification
Get Address Verification	Retrieve a single verification by ID
List Address Verifications	List verifications with optional filters

Next Steps

Verify an Address

End-to-end walkthrough for signature and small deposit methods

Verification Statuses

Status transitions and what triggers each one

FAQ

Troubleshooting and common questions

Questions? Contact Support.

​How Verification Works

​Verification Lifecycle

​Supported Networks

​Required OAuth Scopes

​API Reference

​Next Steps

Verify an Address

Verification Statuses

FAQ

How Verification Works

Verification Lifecycle

Supported Networks

Required OAuth Scopes

API Reference

Next Steps