Embedded Tax API

Partners

Server-to-server partner endpoints under https://api.awaken.tax/api.

POST

/crunch

Create or find a user and add wallets

Field	Type	Required	Notes
`userId`	string	Yes
`email`	string	No	email
`wallets`	array	No

Request body

{
  "userId": "YOUR_USER_REFERENCE",
  "wallets": [
    {
      "address": "YOUR_ETHEREUM_ADDRESS",
      "provider": "ethereum"
    },
    {
      "address": "YOUR_SOLANA_ADDRESS",
      "provider": "solana"
    }
  ]
}

Status	Meaning
`201`	User created or found. Supported wallets added.
`400`	Validation failed

curl

curl -X POST "https://api.awaken.tax/api/crunch" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json" \
  --data '{ "userId": "YOUR_USER_REFERENCE", "wallets": [ { "address": "YOUR_ETHEREUM_ADDRESS", "provider": "ethereum" }, { "address": "YOUR_SOLANA_ADDRESS", "provider": "solana" } ] }'

POST

/discount-codes

Create or retrieve a user's discount code

Field	Type	Required	Notes
`referenceId`	string	Yes
`year`	integer	No	min 2009, max 2100

Request body

{
  "referenceId": "user-42",
  "year": 2025
}

Status	Meaning
`200`	Existing code
`201`	Code created
`403`	Secret-key authentication required

curl

curl -X POST "https://api.awaken.tax/api/discount-codes" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json" \
  --data '{ "referenceId": "user-42", "year": 2025 }'