API Documentation

Welcome to the Chainlink Marketplace API. This documentation provides everything you need to integrate real-time price feeds, cross-chain messaging (CCIP), and decentralized oracle services into your applications.

All Systems Operational

Authentication

All API requests require authentication using an API key. Include your key in the X-API-Key header of each request.

HTTP Header

X-API-Key: your_api_key_here
Content-Type: application/json

Need an API Key?

Contact Craig Brown to request API access for production use cases.

Price Feeds API

GET /api/v1/prices/{pair}

Get the latest price for a specific trading pair (e.g., ETH/USD, BTC/USD)

Parameters

Parameter	Type	Required	Description
pair	string	Required	Trading pair identifier (e.g., "ETH-USD", "BTC-USD")
network	string	Optional	Blockchain network (default: "ethereum")

Example Request

cURL

curl -X GET "http://34.58.12.50/api/v1/prices/ETH-USD" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json"

Example Response

JSON

{
  "success": true,
  "data": {
    "pair": "ETH/USD",
    "price": "3892.45",
    "decimals": 8,
    "timestamp": "2025-12-13T15:30:00Z",
    "round_id": "110680464442257330789",
    "network": "ethereum",
    "feed_address": "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419"
  }
}

Cross-Chain Messaging (CCIP)

POST /api/v1/ccip/send

Send a cross-chain message using Chainlink CCIP

Request Body

JSON

{
  "source_chain": "ethereum",
  "destination_chain": "polygon",
  "receiver": "0x1234...abcd",
  "data": "0x...",
  "token_amounts": [
    {
      "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "amount": "1000000000"
    }
  ]
}

Supported Networks

Network	Chain ID	Status
Ethereum Mainnet	1	Active
Polygon	137	Active
Arbitrum One	42161	Active
Optimism	10	Active
Base	8453	Active
Avalanche	43114	Active

Rate Limits

API requests are rate-limited to ensure fair usage. Current limits:

Tier	Requests/min	Requests/day
Free	60	1,000
Developer	300	10,000
Enterprise	Unlimited	Unlimited

Error Codes

Code	Status	Description
400	Bad Request	Invalid request parameters
401	Unauthorized	Missing or invalid API key
404	Not Found	Resource or endpoint not found
429	Too Many Requests	Rate limit exceeded
500	Internal Error	Server-side error occurred

SDKs & Libraries

Official SDKs Coming Soon

We're developing official SDKs for JavaScript/TypeScript, Python, and Go. In the meantime, use our REST API directly with any HTTP client.