Create Monitoring Address

Adds an address to be monitored for rewards tracking.

Currently only ETHEREUM, SOLANA, INK & XLAYER addresses are supported.

POST /rewards/monitor/address

Try it

cURL

Add a new monitoring address with a name

curl --request POST \
  --url https://api.paxos.com/v2/rewards/monitor/address \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "crypto_network": "ETHEREUM",
  "address": "0x2D2849217C027494ae0D7Af2fC7f9b798Ddd5aB9",
  "name": "New Address"
}
'

200

Setting up a new address to monitor

{
  "address": {
    "address": "0x2D2849217C027494ae0D7Af2fC7f9b798Ddd5aB9",
    "crypto_network": "ETHEREUM",
    "name": "New Address",
    "created_at": "2025-03-21T15:22:05.474383Z"
  }
}

OAuth Scope

rewards:write_monitoring_address

Authorizations

Authorization · string · header · required

Paxos APIs use OAuth 2 with the client credentials grant flow.

Token URLs:

• Production: https://oauth.paxos.com/oauth2/token
• Sandbox: https://oauth.sandbox.paxos.com/oauth2/token

Learn more in the API credentials guide →

Body

application/json

crypto_network · enum<string>

A CryptoNetwork is a blockchain transmitting cryptocurrencies.

Available options: BITCOIN, ETHEREUM, BITCOIN_CASH, LITECOIN, SOLANA, POLYGON_POS, BASE, ARBITRUM_ONE, STELLAR, INK, XLAYER

address · string

On-chain address Paxos will monitor for eligible reward activity. Must be valid for the specified network and not be registered to another customer. For SOLANA specify the wallet account (ie: not a derived/token account like an ATA).

name · string

Optional display name. Useful for grouping or reporting.

Response

200

application/json

A successful response.

address · object

Show child attributes

address. address · string · required

On-chain address Paxos will monitor for eligible reward activity.

address. crypto_network · enum<string> · required

A CryptoNetwork is a blockchain transmitting cryptocurrencies.

Available options: BITCOIN, ETHEREUM, BITCOIN_CASH, LITECOIN, SOLANA, POLYGON_POS, BASE, ARBITRUM_ONE, STELLAR, INK, XLAYER

address. created_at · string<date-time> · required

When the address was registered.

address. id · string · required

UUID direct reference to the created address (to be used for updates).

address. name · string

Optional display name. Useful for grouping or reporting.