# Milypay for Agents

The complete way for AI agents to pay for Australian data. Milypay exposes Australian APIs over the x402 protocol, settled in AUD stablecoins on Solana, and discoverable through Pay.sh, a CLI, an MCP server, SDKs, and raw HTTP 402. No accounts, no API keys.

Agents and crawlers are welcome here. This document describes how to use Milypay programmatically. A Milysec company.

## Quickstart

Request any endpoint. If it returns `HTTP 402 Payment Required`, pay the quoted price in AUDD from an x402-aware wallet and the data returns in the same round-trip.

```
curl https://api.milypay.xyz/au-business/abn/51824753556
```

## Ways to integrate

### CLI

Call any endpoint from your terminal. The Pay.sh CLI handles the 402 challenge and wallet approval for you.

- Zero setup beyond a funded wallet
- Works with every `milysec/*` service
- `npx pay.sh call milysec/au-business/abn 51824753556`

### MCP (Model Context Protocol)

Expose Milypay to any agent through the Pay.sh MCP server. Agents discover, price, and pay for Australian data as tools.

- Drop-in for Claude, Cursor, and other MCP clients
- Tools are auto-priced in AUD
- Discovery and payment handled by the gateway

### SDK

A drop-in x402 client for TypeScript and Python. Wrap fetch and get auto-paid responses.

- No manual payment plumbing
- Typed Australian data responses
- Handles the 402 retry and AUD settlement

### API (raw HTTP 402)

No SDK required. Any x402-aware client speaks directly to the endpoint.

- Standard HTTP, standard 402
- Asset AUDD, network Solana
- Same round-trip settlement

## Services

All services live under the `milysec/*` namespace on Pay.sh.

| Endpoint | What it returns | Price |
| --- | --- | --- |
| `GET /au-business/abn/{abn}` | Entity name, status, type, ACN, GST, business names, location | $0.002 / call |
| `GET /au-business/acn/{acn}` | Same, resolved from an ACN | $0.002 / call |
| `GET /au-business/search?name=` | Matching ABNs by business or entity name | $0.004 / call |
| `GET /au-company/acn/{acn}` | ASIC company: status, type, class, registration dates, former names (open data) | $0.002 / call |
| `GET /au-company/search?name=` | Companies matching a name (current + former names, open data) | $0.004 / call |
| `GET /au-company-report?acn=` | Official ASIC extract (directors, office, share capital). Paid DSP only | $12 / extract |
| `GET /au-address/validate?q=` | Canonical address, GNAF PID, geocode | $0.004 / call |
| `GET /au-address/search?q=` | Ranked address matches (autocomplete) | $0.004 / call |
| `GET /au-address/geocode?q=` | Latitude / longitude for an address | $0.004 / call |
| `GET /au-super/abn/{abn}` | Super fund name, status, type, complying status, USIs | $0.002 / call |
| `GET /au-weather?q={address}` | Current conditions + multi-day forecast for an Australian address | $0.001 / call |
| `GET /au-weather?lat={lat}&lng={lng}` | Same, by coordinate | $0.001 / call |
| `GET /au-postage?from={pc}&to={pc}&weight={kg}` | Australia Post parcel rates + services between postcodes | $0.002 / call |
| `GET /au-postage?country={cc}&weight={kg}` | International parcel rates | $0.002 / call |
| `GET /au-bsb/{bsb}` | BSB lookup: bank name, branch, address, state, postcode, services (P/E/H), merged/redirect flag | $0.002 / call |
| `GET /au-bsb/search?q=` | Search BSBs by bank name, branch, or suburb | $0.004 / call |

BSB numbers can be supplied with or without the hyphen: `012-002` or `012002` both work.

Base URL: `https://api.milypay.xyz`. More Australian services are on the roadmap.

## How payment works

1. Your agent requests a Milypay endpoint, for example `GET https://api.milypay.xyz/au-business/abn/{abn}`.
2. Milypay answers with an x402 challenge: price, asset (AUDD), network (solana), and pay-to address.
3. Your wallet approves the micropayment via the PayAI facilitator. Settlement is in AUDD on Solana, and the data returns in the same request.

## Settlement currency

Milypay is AUD-stablecoin-agnostic. On Solana it accepts **AUDD**, **AUDM**, and **dAUD** for AUD-native settlement, plus **USDC** and **USDT** for pay.sh compatibility. See https://milypay.xyz/stables for the full reference.

## List your API

Wrap any existing Australian API with the Milypay reference implementation, set a price in AUD, and it becomes discoverable and payable by every agent on Pay.sh. Start at https://milypay.xyz/contact.

## FAQ

**What can an agent do with Milypay?**
Discover Australian data services, get a price in AUD, pay per call, and receive data, all autonomously over x402.

**Do I need an account or API key?**
No. Payment is the authentication. Any x402-aware client can transact.

**How do agents pay?**
With an x402-aware wallet. The first response is an HTTP 402 with the price; the wallet approves it and the request is retried with payment.

**What does it cost?**
Per call, priced in AUD. See the services table. No subscriptions or minimums.

**Which currency is settlement in?**
AUD stablecoins on Solana: AUDD, AUDM, and dAUD. USDC and USDT are also accepted for catalog compatibility.

**Which network?**
Solana, via the PayAI x402 facilitator.

## Links

- Home: https://milypay.xyz
- AUD stablecoins: https://milypay.xyz/stables
- Contact and list an API: https://milypay.xyz/contact
- Catalog: https://pay.sh (namespace `milysec/*`)
- x402 specification: https://x402.org
- Parent company: https://milysec.com