API Reference

API Reference

Process Transaction

Simulates and analyzes a submitted transaction, comparing the actual execution with the provided reason (intent) — what the transaction is expected to do.

Based on the analysis, the system determines whether the transaction should be approved or rejected, and flags any risks or mismatches with the original intent

Base URL

http://apib.baibysitter.xyz

Endpoint

POST /api/transaction

Swagger

http://apib.baibysitter.xyz/docs#tag/default/post/api/transaction

---

Request

Headers

Content-Type: application/json

Body Parameters

Field	Type	Required	Description
chainId	Integer	✅ Yes	Blockchain network ID
from_address	String	✅ Yes	Sender wallet address
to_address	String	✅ Yes	Recipient wallet address
data	String	✅ Yes	Encoded transaction data
value	String	No (default "0")	ETH or native token value sent
reason	String	Optional	Declared intent for the transaction (e.g., "swap 1 ETH for USDC")

---

Example Request

Shell / cURL

curl http://apib.baibysitter.xyz/api/transaction   --request POST   --header 'Content-Type: application/json'   --data '{
    "chainId": 8453,
    "from_address": "0x2af7BA938d51353A5eE998cDB770e006C57b252B",
    "to_address": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b",
    "data": "0xa9059cbb0000000000000000000000007357ad9f66b6e4e056f8f4a469844f4fab00f1440000000000000000000000000000000000000000000000007ce66c50e2840000",
    "value": "0",
    "reason": "i want to transfer 9 virtuals to 0x7357ad9F66B6E4e056F8f4a469844F4faB00F145"
  }'

---

Responses

200 OK

{
  "transaction_id": "497da974-7e74-461e-a85d-40b469ef6d1f",
  "validations": {
    "agent": {
      "risks_detected": [
        "Intent mismatch between Primary Reason and simulated behavior"
      ],
      "status": "rejected",
      "message": "The transaction is rejected due to a mismatch in recipient addresses between the Primary Reason and sentinel information. Expected recipient 0x7357ad9F66B6E4e056F8f4a469844F4faB00F145 but found 0x7357ad9f66b6e4e056f8f4a469844f4fab00f144. This could indicate a potential risk of funds being sent to an unintended recipient.",
      "warnings_considered": []
    }
  },
  "created_at": "2025-09-17T01:45:55.700394",
  "updated_at": "2025-09-17T01:46:08.676536",
  "status": "completed"
}

422 Validation Error

{
  "detail": [
    {
      "loc": ["body", "chainId"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

---

Example Use Cases

• ERC-20 transfer: Validate that the declared recipient matches the simulated execution.

• Swap: Detect mismatches between expected and actual tokens received.

• Approval: Detect infinite approvals or approvals to malicious addresses.