POST
/
farcaster
/
frame
/
transaction
/
pay
curl --request POST \
  --url https://api.neynar.com/v2/farcaster/frame/transaction/pay \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "transaction": {
    "to": {
      "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
      "network": "base",
      "token_contract_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "amount": 0.01
    }
  },
  "config": {
    "allowlist_fids": [
      3
    ],
    "line_items": [
      {
        "name": "Payment",
        "description": "Payment for goods",
        "image": "https://i.imgur.com/ovGo3sz.png"
      }
    ],
    "action": {
      "text": "Pay",
      "text_color": "#FFFFFF",
      "button_color": "#000000"
    }
  },
  "idem": "<string>"
}'
{
  "transaction_frame": {
    "id": "<string>",
    "url": "<string>",
    "type": "pay",
    "config": {
      "allowlist_fids": [
        3
      ],
      "line_items": [
        {
          "name": "Payment",
          "description": "Payment for goods",
          "image": "https://i.imgur.com/ovGo3sz.png"
        }
      ],
      "action": {
        "text": "Pay",
        "text_color": "#FFFFFF",
        "button_color": "#000000"
      }
    },
    "status": "created",
    "transaction": {
      "to": {
        "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
        "network": "base",
        "token_contract_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "amount": 0.01
      }
    }
  }
}

Read more about this API here: Make agents prompt transactions

Authorizations

x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Body

application/json
transaction
object
required
config
object
required
idem
string

An Idempotency key is a unique identifier for the request. Note:

  1. This is used to prevent duplicate requests. Use the same idem key on retry attempts.
  2. This should be a unique identifier for each request.
  3. Recommended format is a 16-character string generated by the developer at the time of making this request.

Response

200
application/json
Transaction mini app successfully created
transaction_frame
object
required