Send USDC from the app resolved by the API key

Resolve recipient and amount from context, then spend USDC through the app associated with the calling API key. This is the app-id-free transfer route used by the current HEVN CLI.

POST /api/v1/apps/transfer

Send USDC from the app resolved by the API key

cURL

curl --request POST \
  --url https://api.hevn.finance/api/v1/apps/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "quoteId": "<string>",
  "invoiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 123,
  "memo": "<string>"
}
'

import requests

url = "https://api.hevn.finance/api/v1/apps/transfer"

payload = {
    "contactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "quoteId": "<string>",
    "invoiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "amount": 123,
    "memo": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contactId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    quoteId: '<string>',
    invoiceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    amount: 123,
    memo: '<string>'
  })
};

fetch('https://api.hevn.finance/api/v1/apps/transfer', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "txHash": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

HTTPBearerApiKeyAuth

Authorization · string · header · default: Bearer <token> · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key · string | null

x-api-key · string

Alternative API key header. Use Authorization Bearer by default, or X-Api-Key when that header mode is configured.

Body

application/json

Body of POST /apps/transfer.

Exactly one of contactId / quoteId / invoiceId MUST be set (mirrors the /mcp/transfer body). amount is required when contactId is the dispatch path; otherwise it's derived from the referenced invoice / quote.

contactId · string<uuid> | null

quoteId · string | null

invoiceId · string<uuid> | null

amount · number | null

memo · string | null

Response

200

application/json

Successful Response

txHash · string · required