# Milypay

## When to use

Use for Australian pay-per-call data (ABN, ASIC, G-NAF, ABS, transit, NEM, etc.) via x402, CLI, SDK, or MCP. Not for non-AU bulk dumps or classic API-key SaaS.

 - Full Reference

> Milypay is the x402 service provider for the Australian market. AI agents pay per call for Australian data and settle in AUD stablecoins (AUDD and others), via the PayAI facilitator and the Pay.sh catalog. No API keys, no signup. A Milysec company.

This is the long-form reference for language models and agents. For the short version see https://milypay.xyz/llms.txt . For the human and agent guide see https://milypay.xyz/agents.md . Machine-readable discovery manifest: https://milypay.xyz/.well-known/x402 .

- Site: https://milypay.xyz
- API base URL: https://api.milypay.xyz
- Catalog: https://pay.sh (namespace milysec/*)
- x402 specification: https://x402.org
- Settlement asset: AUDD (Australian Digital Dollar), mint AUDDttiEpCydTm7joUMbYddm72jAWXZnCpPZtDoxqBSw, 6 decimals, Solana mainnet
- Pay-to wallet: mi1ytDfgNFYgm54y4f3xzRQbfbyCz6TBmQcAL3brozA
- Facilitator: https://facilitator.payai.network

## How payment works (x402)

1. Request an endpoint, for example GET https://api.milypay.xyz/au-business/abn/51824753556
2. The first response is HTTP 402 Payment Required. The PAYMENT-REQUIRED header carries a base64 x402 challenge with the price, asset (AUDD), network (solana), and pay-to address.
3. Approve the micropayment from an x402-aware wallet or client. The request is retried with a PAYMENT-SIGNATURE header, the facilitator verifies and settles in AUDD, and the data returns in the same round-trip.

No accounts, no keys. Any x402-aware client, the Milypay CLI, an SDK, or the Milypay MCP server (`npx milypay mcp`) can transact. Prices below are per call, in AUDD.

## Endpoints

### au-business - Business identity (ABR / Australian Business Register)

GET /au-business/abn/{abn} - price 0.002
  Australian business by ABN. Returns entity name, ABN status, type, ACN, GST registration, business names, location.
  Example: GET https://api.milypay.xyz/au-business/abn/33051775556
  Example response:
  {"abn":"33051775556","abnStatus":"Active","abnStatusFrom":"1999-11-01","acn":"051775556","entityName":"TELSTRA CORPORATION LIMITED","entityType":"Australian Public Company","businessNames":["TELSTRA INFRACO","TELECOM AUSTRALIA","YELLOW PAGES"],"gstRegistered":true,"gstFrom":"2000-07-01"}

GET /au-business/acn/{acn} - price 0.002
  Same as above, resolved from an ACN.
  Example: GET https://api.milypay.xyz/au-business/acn/004085616

GET /au-business/search?name={name}&maxResults={n} - price 0.004
  ABN name search by business or entity name. Returns matching ABNs with status, state, postcode, score.
  Example: GET https://api.milypay.xyz/au-business/search?name=woolworths

### au-company - ASIC company register

GET /au-company/acn/{acn} - price 0.002
  ASIC company by ACN. Returns name, ABN, status, statusCode, type, class, registration and deregistration dates, former names.
  Example: GET https://api.milypay.xyz/au-company/acn/000014675
  Example response:
  {"acn":"000014675","abn":"88000014675","name":"Woolworths Group Limited","status":"Registered","statusCode":"REGD","type":"Australian public company","class":"Limited by shares","registrationDate":"1924-09-22","deregistrationDate":null,"previousState":"NSW","formerNames":["Woolworths Ltd"]}

GET /au-company/search?name={name}&limit={n} - price 0.004
  ASIC company name search across current and former names (open data).
  Example: GET https://api.milypay.xyz/au-company/search?name=woolworths

### au-company-report - Official ASIC company extract

GET /au-company-report?acn={acn}&type=current|historical - price 12.00 (live). Returns pdfBase64. Demo host = sandbox free.
POST /au-company-report - price 12.00 (JSON body: {"acn":"000014675"})
  Official ASIC company extract (directors, office, share capital, charges where available).
  Not available from free ASIC open data or ABR. Ordered via Business API DSP. Always paid.
  Example: GET https://api.milypay.xyz/au-company-report?acn=000014675

### au-address - Address (G-NAF, Geoscape, 16.9M addresses)

GET /au-address/validate?q={address} - price 0.004
  Validate an Australian address. Returns valid flag, canonical address, GNAF PID, components, latitude, longitude.
  Example: GET https://api.milypay.xyz/au-address/validate?q=1 bligh st sydney

GET /au-address/search?q={query}&limit={n} - price 0.004
  Ranked address matches (autocomplete).
  Example: GET https://api.milypay.xyz/au-address/search?q=120 collins st melbourne

GET /au-address/geocode?q={address} - price 0.004
  Latitude and longitude for an address.
  Example: GET https://api.milypay.xyz/au-address/geocode?q=200 adelaide st brisbane
  Example response:
  {"found":true,"query":"200 adelaide st brisbane","lat":-27.46692633,"lng":153.02635408,"address":"200 Adelaide Street, Brisbane City QLD 4000","gnafPid":"GAQLD163129955"}

### au-super - Super Fund Lookup (ATO)

GET /au-super/abn/{abn} - price 0.002
  Verify any Australian super fund by ABN. Returns fund name, status, type, complying status, suburb, state, postcode, and product USIs.
  Example: GET https://api.milypay.xyz/au-super/abn/65714394898
  Example response:
  {"abn":"65714394898","abnStatus":"Active","fundName":"The Trustee for AUSTRALIANSUPER","fundType":"APRA Regulated Public Offer Fund","complyingStatus":"APRA Registered","suburb":"MELBOURNE","state":"VIC","postcode":"3000","products":[{"usi":"STA0002AU","productName":"AustralianSuper Pension"}]}

### au-weather - Weather (BOM ACCESS-G via Open-Meteo)

GET /au-weather?q={address}&days={n} - price 0.001
  Current conditions and multi-day forecast for an Australian address (geocoded via G-NAF).
  Example: GET https://api.milypay.xyz/au-weather?q=1 bligh st sydney&days=2

GET /au-weather?lat={lat}&lng={lng}&days={n} - price 0.001
  Same, by coordinate.
  Example: GET https://api.milypay.xyz/au-weather?lat=-33.87&lng=151.21&days=2

### au-bsb - BSB directory (AusPayNet)

GET /au-bsb/{bsb} - price 0.002
  Lookup a BSB number. Accept 6 digits with or without hyphen: 012-002 or 012002.
  Returns: bsb, bank (3-char mnemonic), bankName (full institution name), branch, address, suburb, state, postcode, services (array of human-readable payment method strings), merged (bool), mergedTo (BSB string if merged, else null).
  Example: GET https://api.milypay.xyz/au-bsb/012-002
  Example response:
  {"bsb":"012-002","bank":"ANZ","bankName":"Australia & New Zealand Banking Group Limited","branch":"ANZ Smart Choice","address":"115 Pitt Street","suburb":"Sydney","state":"NSW","postcode":"2000","services":["Paper (cheques, APCS)","Electronic (direct entry)","High value (HVCS, same-day large payments)"],"merged":false,"mergedTo":null}

GET /au-bsb/search?q={query}&limit={n} - price 0.004
  Search BSBs by bank name, branch name, or suburb. Returns up to limit (max 20) matching records.
  Example: GET https://api.milypay.xyz/au-bsb/search?q=westpac+sydney

### au-postage - Australia Post (PAC)

GET /au-postage?from={postcode}&to={postcode}&weight={kg}&length={cm}&width={cm}&height={cm} - price 0.002
  Domestic parcel rates and service options between two postcodes. Length, width, and height are required for domestic parcels.
  Example: GET https://api.milypay.xyz/au-postage?from=2000&to=3000&weight=1&length=10&width=10&height=10

GET /au-postage?country={code}&weight={kg} - price 0.002
  International parcel rates and service options.
  Example: GET https://api.milypay.xyz/au-postage?country=US&weight=0.5

## 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. Settling in AUD removes the USD foreign-exchange round-trip that USDC-only x402 services require. AUD stablecoin reference: https://milypay.xyz/stables .

## Ways to integrate

- CLI: npx milypay abn 51824753556
- SDK: a drop-in x402 client for TypeScript and Python that wraps fetch and handles the 402 retry and AUD settlement.
- MCP: add the Milypay MCP server (`npx milypay mcp`) to Claude, ChatGPT, Cursor, or any Model Context Protocol client; agents discover, price, and call services as tools.
- Raw HTTP 402: any x402-aware client speaks directly to the endpoint.

## FAQ

Q: What is Milypay?
A: Milypay is the x402 service provider for the Australian market. It gives AI agents pay-per-call access to Australian data settled in AUDD, the regulated AUD-native stablecoin, with no API keys and no signup. A Milysec company.

Q: Do I need an API key or account?
A: No. Milypay has no accounts, no API keys, and no signup. Any x402-aware client pays per call and receives the data back.

Q: How do I give my AI agent access to Australian data?
A: Point your agent at https://milypay.xyz/agents.md, or add the Milypay MCP server (`npx milypay mcp`) to Claude, ChatGPT, Cursor, or any MCP-compatible client.

Q: What is AUDD?
A: AUDD is a 1:1 AUD-backed, AFSL-regulated stablecoin live on Solana. It is Milypay's default settlement asset.

## About

Milypay is a Milysec company (https://milysec.com). Built for Australia. Settled in AUD stablecoins. To list an Australian API: https://milypay.xyz/contact . Milypay provides settlement and data services only; nothing here is an investment offer.

## ABS statistics

Australian Bureau of Statistics via SDMX Data API (no upstream key).

```
GET /au-abs/dataflows?q=CPI
GET /au-abs/dataflow/CPI
GET /au-abs/data/CPI?key=1.10001.10.50.Q&startPeriod=2020
GET /au-abs/cpi
```

CLI: `npx milypay cpi` · `npx milypay abs dataflows wage`
MCP: `abs_cpi`, `abs_dataflows`, `abs_data`
Prices: dataflows/meta $0.002 · data $0.005 · cpi $0.003
Attribution: ABS CC BY 4.0

## Public transport (GTFS-Realtime)

Live open feeds (no upstream key):

| Region | Id | Operator |
|--------|----|----------|
| South East Queensland | `seq` | Translink |
| Adelaide | `sa` | Adelaide Metro |

```
GET /au-transit/regions
GET /au-transit/seq/vehicles?limit=20
GET /au-transit/seq/trip-updates?routeId=
GET /au-transit/sa/alerts
GET /au-transit/seq/summary
```

CLI: `npx milypay transit seq vehicles --limit 10`
MCP: `transit_vehicles`, `transit_trip_updates`, `transit_alerts`, `transit_summary`, `transit_regions`
Prices: regions $0.001 · summary/alerts $0.002 · vehicles/trips $0.003

Regions: seq, sa, vic (metro|tram|bus|vline), nsw (buses|sydneytrains|metro|nswtrains|ferries|lightrail).

## Energy (AEMO NEM)

Live wholesale electricity — no upstream key:

```
GET /au-energy
GET /au-energy/nem
GET /au-energy/nem/NSW1
GET /au-energy/nem/VIC
GET /au-energy/notices?limit=10
```

CLI: `npx milypay nem` · `npx milypay nem vic` · `npx milypay energy notices`
MCP: `energy_nem` · `energy_nem_region` · `energy_notices`
Prices: catalogue $0.001 · nem/notices $0.002

Wholesale spot $/MWh (not retail). Regions: NSW1 QLD1 SA1 TAS1 VIC1.
Source: AEMO ELEC_NEM_SUMMARY.

## Phone line lookup

Line intelligence only (not personal identity / CNAM):

```
GET /au-phone?number=%2B61412345678
GET /au-phone/%2B61412345678
```

AU mobiles accepted as `04xxxxxxxx` (normalized to +61).

Returns: valid, country, national format, line type, carrier name, MCC/MNC.

CLI: `npx milypay phone +61412345678`
MCP: `lookup_phone`
Price: **$0.05** / call

Does **not** return caller name or person identity for anonymous x402 wallets.

## Discovery

- OpenAPI: https://milypay.xyz/openapi.json
- API catalog: https://milypay.xyz/.well-known/api-catalog
- MCP: https://milypay.xyz/mcp