API v1 — Generally Available

The market layer for
autonomous software.

Connect your applications and AI agents to market data, opportunity intelligence, valuation and authorized execution through one API.

Get a GridKey Read the Docs
curl -X GET https://api.madenode.dev/v1/opportunities/search \
-H "Authorization: Bearer gl_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"domain": true, "min_score": 80}'

Capabilities

Everything your agent needs.
One API surface.

Built for AI developers, autonomous agents, SaaS companies, digital asset tools, and market-analysis applications.

Market Data

Unified normalized market data across asset types. Real-time pricing, historical comparisons, and market signals.

Opportunity Discovery

Search and rank opportunities from configured sources. Filter by score, type, market, and custom criteria.

Intelligence

Scores, valuations, comparisons and risk analysis. GridScore proprietary evaluation system.

Execution

Authorized transactions through supported provider APIs. Idempotent, auditable, and rate-limited.

Portfolio Intelligence

Asset monitoring, performance tracking, and portfolio analytics across connected providers.

Agent Infrastructure

Webhooks, API keys, usage controls, rate limits, event streams, and billing for autonomous systems.

Developer Experience

Consistent. Predictable. Fast.

Every response follows the same structure. Every error includes a clear code and message. Rate limits are transparent. Idempotency is built in.

✓
Versioned API

Stable base URL with /v1 prefix. Breaking changes never ship on existing versions.

✓
Idempotent Execution

Send an Idempotency-Key header. Duplicate requests never double-charge or double-execute.

✓
Webhook Events

HMAC-signed callbacks for opportunities, executions, credit events, and key lifecycle.

✓
Prepaid Credits

GRID credits are service credits, not cash. Immutable ledger. No surprise charges.

Response format
{
  "data": {
    "id": "opp_a1b2c3d4",
    "type": "domain",
    "identifier": "premium-example.dev",
    "score": 94.2,
    "valuation": {
      "retail": 7995,
      "wholesale": 4200
    },
    "confidence": 0.87
  },
  "meta": {
    "request_id": "req_x7k9m2",
    "credits_used": 25,
    "credits_remaining": 98241
  }
}
Error format
{
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires 25 GRID."
  },
  "meta": {
    "request_id": "req_x7k9m3"
  }
}

Pricing

Prepaid GRID credits.
No subscriptions. No surprises.

GRID credits are service credits for API access, data queries, and computational services. They are not cash, not withdrawable, and not investment capital.

GridKey Alpha
$179.99
100,000 GRID
✓ Market data queries
✓ Opportunity feed access
✓ Intelligence requests
✓ Valuations & scoring
✓ Monitoring & webhooks
Get Started
POPULAR
GridKey Pro
$449.99
300,000 GRID
✓ Everything in Alpha
✓ Execution requests
✓ Higher rate limits
✓ Priority support
✓ 3 API keys included
Get Started
GridKey Quant
$999.99
850,000 GRID
✓ Everything in Pro
✓ Unlimited rate limits
✓ Custom webhook config
✓ Dedicated support
✓ 10 API keys included
Get Started

Enterprise plans available. Contact sales.

API Reference

RESTful by default.
Designed for machines.

Base URL
https://api.madenode.dev/v1
GET /health Health check
GET /account Account info
GET /usage Credit usage
POST /opportunities/search Search opportunities
GET /opportunities/{id} Get opportunity
POST /assets/analyze Analyze asset
POST /assets/value Get valuation
POST /executions Submit execution
GET /executions/{id} Get execution status

Build the agent.
We provide the market.

Get started with a GridKey in minutes. Prepaid credits. No subscriptions.

Get a GridKey