RailPayDocs
Sandbox. No real funds move and nothing settles on a chain yet. What this means

API reference

Agents

Agent wallets, funding, policy and events.

POST/v1/agentsSession or account key

Create an agent. Returns the agent and its first agent key (shown once).

Body
{ "name": "research-bot" }
Response
{ "agent": { "id": "agt_…", "name": "research-bot", "balance": 0, "spent_today": 0, "policy": { … } }, "key": { "id": "key_…", "key": "rp_sk_…", "prefix": "rp_sk_…" } }
curl
curl -X POST https://dapp.railpay.app/v1/agents \
  -H "Authorization: Bearer $RAILPAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "research-bot" }'
GET/v1/agentsSession or account key

Your agents with balance, today's spend and policy.

curl
curl https://dapp.railpay.app/v1/agents \
  -H "Authorization: Bearer $RAILPAY_KEY"
GET/v1/agents/:idSession or account key

One agent.

curl
curl https://dapp.railpay.app/v1/agents/<id> \
  -H "Authorization: Bearer $RAILPAY_KEY"
POST/v1/agents/:id/fundSession or account key

Move SUSD from your account to the agent.

Body
{ "amount": "5" }
curl
curl -X POST https://dapp.railpay.app/v1/agents/<id>/fund \
  -H "Authorization: Bearer $RAILPAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": "5" }'
POST/v1/agents/:id/withdrawSession or account key

Move SUSD from the agent back to your account.

Body
{ "amount": "5" }
curl
curl -X POST https://dapp.railpay.app/v1/agents/<id>/withdraw \
  -H "Authorization: Bearer $RAILPAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": "5" }'
PATCH/v1/agents/:id/policySession or account key

Update the policy.

Body
{ "per_request_max": "0.05", "daily_cap": "5", "allowed_hosts": ["dapp.railpay.app"], "allow_a2a": false, "paused": false }
curl
curl -X PATCH https://dapp.railpay.app/v1/agents/<id>/policy \
  -H "Authorization: Bearer $RAILPAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "per_request_max": "0.05", "daily_cap": "5", "allowed_hosts": ["dapp.railpay.app"], "allow_a2a": false, "paused": false }'
GET/v1/agents/:id/eventsSession or account key

Paid and blocked attempts with reasons.

curl
curl https://dapp.railpay.app/v1/agents/<id>/events \
  -H "Authorization: Bearer $RAILPAY_KEY"

The RailPay app runs in Sandbox mode. Balances are in Sandbox USD (SUSD). No real funds move and nothing settles on a chain. Chains, stablecoins, card issuing, ramps, fees and yield are TBD.

© 2026 RailPay. Built as practical payment infrastructure, not a token or fundraising project.