Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.meow.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Prerequisites

  • A Meow account with contacts management capabilities
  • An API key with the contacts:read and contacts:write permissions

​
Understanding Cryptocurrency Contacts

Cryptocurrency contacts store blockchain addresses that you frequently send USDC to. Each contact includes:
  • A friendly nickname for easy identification
  • A cryptocurrency address for a specific blockchain network
  • A static memo ID used when creating transactions

​
Creating Cryptocurrency Contacts

​
Step 1: Prepare Contact Information

Before creating a contact, gather the following information:
  • A nickname for the contact
  • The cryptocurrency address
  • The blockchain network the address belongs to (Ethereum, Solana, Base)
Ensure the cryptocurrency address is valid for the selected blockchain network.

​
Step 2: Create the Contact

Use the following API call to create a new USDC contact: 
curl -X POST "https://api.meow.com/v1/contacts/usdc" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "nickname": "Lion",
    "crypto_address": {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "payment_rail": "ethereum"
    }
  }'
Replace:
  • Lion with your preferred nickname
  • The address with the actual cryptocurrency address
  • payment_rail with either ethereum, solana, or base depending on the blockchain network

​
Step 3: Review the Response

A successful response will include details about the created contact: 
{
  "id": "cont_987654321",
  "nickname": "Lion",
  "static_memos": {
    "ethereum": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "destination_address": "0x1234567890abcdef1234567890abcdef12345678",
      "destination_payment_rail": "ethereum"
    }
  }
}
Note the static_memos object, which contains the id you’ll need when creating USDC transactions. Each blockchain network the contact supports will have its own entry in the static_memos object.

​
Listing Cryptocurrency Contacts

To view all your existing contacts, use the following API call: 
curl -X GET "https://api.meow.com/v1/contacts" \
  -H "x-api-key: YOUR_API_KEY"
You can optionally filter contacts by nickname using the nickname_query parameter: 
curl -X GET "https://api.meow.com/v1/contacts?nickname_query=Lion" \
  -H "x-api-key: YOUR_API_KEY"
Example response: 
{
  "data": [
    {
      "id": "cont_987654321",
      "nickname": "Lion",
      "static_memos": {
        "ethereum": {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "destination_address": "0x1234567890abcdef1234567890abcdef12345678",
          "destination_payment_rail": "ethereum"
        }
      }
    },
    {
      "id": "cont_123456789",
      "nickname": "Lion 2",
      "static_memos": {
        "solana": {
          "id": "7bc85f64-5717-4562-b3fc-2c963f66abc8",
          "destination_address": "8xDc123456789abcdef123456789abcdef123456789abcdef",
          "destination_payment_rail": "solana"
        }
      }
    }
  ]
}

​
Deleting Cryptocurrency Contacts

If you no longer need a contact, you can delete it using the following API call: 
curl -X DELETE "https://api.meow.com/v1/contacts/{contact_id}" \
  -H "x-api-key: YOUR_API_KEY"
Replace {contact_id} with the ID of the contact you want to delete. A successful deletion will return a 204 No Content status code with no response body.

​
Best Practices for Contact Management

  1. Verify Addresses Carefully: Always double-check cryptocurrency addresses before creating contacts. Blockchain transactions cannot be reversed if sent to the wrong address.
  2. Use Descriptive Nicknames: Choose clear, descriptive nicknames that help you identify the purpose or owner of each contact.
  3. Test with Small Amounts: Before sending large transactions to a new contact, verify the address works correctly by sending a small test amount.
  4. Audit Regularly: Periodically review your contacts list to remove any that are no longer needed or have outdated information.
  5. Document Static Memo IDs: Keep a secure record of contact IDs and their corresponding static memo IDs for ease of creating transactions.

​
Understanding the Contact Response

When creating or listing contacts, the API response contains several important fields:
FieldDescription
idUnique identifier for the contact
nicknameUser-friendly name you assigned to the contact
static_memosContains blockchain-specific information
static_memos.[network].idThe static memo ID used when creating transactions
static_memos.[network].destination_addressThe cryptocurrency address for this network
static_memos.[network].destination_payment_railThe blockchain network identifier
The static_memos object may contain multiple entries if the contact has addresses on different blockchain networks.